Create Split Payments

POST 
/payments

Use this endpoint to create a split payment.

Request

Header Parameters

Authorization string
appToken created by /auth/token Format: Bearer xxxxxx...
Example: Bearer <appToken>

application/json

Body

required

data

object

A key for grouping different types of API data.

type string

The type of transaction.

attributes

object

A key for grouping payment identification data.

paymentType string

Possible values: [tokenv3Split]

The type of payment transaction.

merchantId string

The merchant account number.

miscData string

Optional additional information to store with the call (optional).

transaction

object

A key for grouping payment transaction data. Required for all payment types except secondSplit.

amount string

The transaction amount in cents.

currency string

The three-character code.

invoice string

The invoice number for the transaction.

token

object

A key for grouping payment token information.

holder string

The first and last name on the account.

tokenId string

The Token ID retrieved from the embedded checkout.

expiry string

The expiration date of the payment method.

useAVS boolean

True/False for requiring a ZIP match (or greater) to capture the payment.

billingAddress

object

A key for grouping billing address data.

line1 string

The card holder’s street address (optional but recommended).

line2 string

The card holder’s additional street address information (optional but recommended).

city string

The card holder’s home city (optional but recommended).

state string

The card holder’s home state (optional but recommended).

zip string

The card holder’s zip or postal code (optional, but recommended.)

country string

The card holder’s home country (optional but recommended).

split

object

A key for grouping split information.

merchantId string

The merchant ID for the split transaction.

amount string

The amount to be split in cents.

Responses

201

Created

application/json

Schema

Schema

links

object

self string

URL for the current resource.

data

object

type string

The type of transaction.

id string

The payment transaction identification code.

attributes

object

A key for grouping payment identification data.

paymentType string

The application key.

transaction

object

A key for grouping payment identification data.

code string

The banking entity response code.

message string

The status of the transaction.

amount string

The transaction amount in dollars and cents.

invoice string

The invoice number for the transaction.

currency string

The currency used for the transaction.

Example (from schema)

{
  "links": {
    "self": "string"
  },
  "data": {
    "type": "string",
    "id": "string",
    "attributes": {
      "paymentType": "string",
      "transaction": {
        "code": "string",
        "message": "string",
        "amount": "string",
        "invoice": "string",
        "currency": "string"
      }
    }
  }
}

Result

{
  "links": {
    "self": "x"
  },
  "data": {
    "type": "payments",
    "id": "{paymentId}",
    "attributes": {
      "paymentType": "card",
      "transaction": {
        "code": "0",
        "message": "Success",
        "amount": "500",
        "invoice": "123456",
        "currency": "USD",
        "authCode": "A11111",
        "avsResult": "T",
        "gross": "500",
        "net": "450",
        "grossMinusNet": "50",
        "fee": "35",
        "rate": "2.95"
      }
    }
  }
}

Loading...