Create Payments
POST/payments
Use this endpoint to create a payment.
Request
Header Parameters
appToken created by /auth/token
Format: Bearer xxxxxx...
- application/json
Body
required
data
object
A key for grouping different types of API data.
The type of transaction.
attributes
object
A key for grouping payment identification data.
Possible values: [tokenv3
]
The type of payment transaction.
The merchant account number.
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
.
The transaction amount in cents.
The three-character code.
The invoice number for the transaction.
token
object
A key for grouping payment token information.
The first and last name on the account.
The Token ID retrieved from the embedded checkout.
The expiration date of the payment method.
True/False for requiring a ZIP match (or greater) to capture the payment.
billingAddress
object
A key for grouping billing address data.
The card holder’s street address (optional but recommended).
The card holder’s additional street address information (optional but recommended).
The card holder’s home city (optional but recommended).
The card holder’s home state (optional but recommended).
The card holder’s zip or postal code (optional, but recommended.)
The card holder’s home country (optional but recommended).
Responses
- 201
Created
- application/json
- Schema
- Example (from schema)
- Result
Schema
links
object
URL for the current resource.
data
object
The type of transaction.
The payment transaction identification code.
attributes
object
A key for grouping payment identification data.
The application key.
transaction
object
A key for grouping payment identification data.
The banking entity response code.
The status of the transaction.
The transaction amount in dollars and cents.
The invoice number for the transaction.
The currency used for the transaction.
{
"links": {
"self": "string"
},
"data": {
"type": "string",
"id": "string",
"attributes": {
"paymentType": "string",
"transaction": {
"code": "string",
"message": "string",
"amount": "string",
"invoice": "string",
"currency": "string"
}
}
}
}
{
"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"
}
}
}
}