🚧 This project is currently in active development. A sandbox environment will be made available soon for testing and exploration. Stay tuned!

Process Card Payment (Sale Handler)

Sandbox

POST

/sale-handler

Processes a card payment for a given session. Called internally by the SDK after the user submits card details. Supports 3-D Secure authentication flows. Note: This endpoint is called by the native SDK — you should not need to call it directly.

Request

Authorization

API Key

Add parameter in header

api_key

Example:

api_key: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Payment processed (success, failure, or 3DS redirect)

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/sale-handler' \
--header 'api_key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "session_id": "0357b0fa0d90f144246ba654eb2f2071",
    "card_number": "4929421234600821",
    "cvv": "356",
    "exp_month": "12",
    "exp_year": "29",
    "billing_address": "7 West Jana",
    "billing_post_code": "SW1A 1AA",
    "save_card": true,
    "card_holder_name": "John Doe",
    "deviceInfo": {
        "deviceChannel": "browser",
        "deviceScreenResolution": "1440x900x30",
        "deviceIdentity": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...",
        "deviceAcceptContent": "application/x-www-form-urlencoded",
        "deviceAcceptEncoding": "gzip, deflate, br",
        "deviceAcceptLanguage": "en-GB",
        "deviceTimeZone": -330,
        "deviceColorDepth": 30,
        "deviceScreenHeight": 900,
        "deviceScreenWidth": 1440
    }
}'

Response Example

200 - Successful payment (non-3DS)

{
    "status": "success",
    "sale_id": "TXN123456789",
    "reference": "REF987654321",
    "message": "Payment successful"
}

Get Session Details

CreateSessionRequest