Sale with a Fee Terminal

POST

/payment/sale

In some cases, there can be 2 terminals involved in one transaction. We call this functionality a Fee Terminal.

You can utilize this endpoint if your merchant account is setup to have a separate fee terminal. The transaction will be divided into two separate authorizations and captures.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "terminal": {
        "id": 24
    },
    "amount": "20.99",
    "source": "Internet",
    "level": 1,
    "card": {
        "name": "John Wick",
        "number": 5309572686772257,
        "exp": "12/30",
        "cvv": 998,
        "address": {
            "country": "United State of America",
            "state": "CA",
            "city": "Calabasas",
            "street": "8320",
            "zip": "85284"
        }
    },
    "order": {
        "tax": {
            "amount": 0.23,
            "details": [
                {
                    "category": "Service",
                    "type": "ServiceFee",
                    "amount": 0.23
                }
            ]
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/payment/sale' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "terminal": {
        "id": 24
    },
    "amount": "20.99",
    "source": "Internet",
    "level": 1,
    "card": {
        "name": "John Wick",
        "number": 5309572686772257,
        "exp": "12/30",
        "cvv": 998,
        "address": {
            "country": "United State of America",
            "state": "CA",
            "city": "Calabasas",
            "street": "8320",
            "zip": "85284"
        }
    },
    "order": {
        "tax": {
            "amount": 0.23,
            "details": [
                {
                    "category": "Service",
                    "type": "ServiceFee",
                    "amount": 0.23
                }
            ]
        }
    }
}'

Responses

🟢200Sale with a Fee Terminal

application/json

Body

Example

{
    "id": 891,
    "amount": "20.76",
    "origin": null,
    "type": "Auth",
    "level": 1,
    "authCode": "VTLMC1",
    "parent": {
        "id": null
    },
    "terminal": {
        "id": 24
    },
    "threeds": {
        "id": null
    },
    "card": {
        "bin": 530957,
        "name": "John Wick",
        "number": 2257,
        "exp": "2030-12-31",
        "verification": {
            "cvv": "M",
            "address": "Y"
        },
        "networkTransactionId": "1212MCC111330**"
    },
    "contact": {
        "name": null,
        "phone": null,
        "email": null
    },
    "externalId": null,
    "isRecurring": "No",
    "split": null,
    "refunded": false,
    "captured": true,
    "history": [
        {
            "id": 893,
            "type": "Capture",
            "amount": "20.76",
            "createdOn": "2023-05-09 16:24:04"
        }
    ],
    "order": null,
    "feeTransaction": {
        "id": 892,
        "type": "Sale",
        "amount": "0.23",
        "createdOn": "2023-05-09 16:24:03"
    },
    "batch": {
        "id": null,
        "number": null,
        "batchedOn": null
    },
    "ip": {
        "address": "173.239.211.191",
        "isp": "Ipxo Limited",
        "type": "hosting",
        "location": {
            "city": "New York",
            "state": "NY",
            "country": "US",
            "zip": "10118"
        },
        "info": {
            "isAnonymous": "Yes",
            "isAnonymousVpn": "No",
            "isPublicProxy": "No",
            "isHostingProvider": "No",
            "isTorExitNode": "No"
        }
    },
    "status": {
        "status": "Approved",
        "reason": null
    },
    "updatedOn": "2023-05-09 16:24:06",
    "createdOn": "2023-05-09 16:24:01"
}

Modified at 2025-08-09 05:39:41

Card Tokenization with Global Token

Hosted Form