Sign in

v1

latestOpenAPI 3.0.12026-07-2679100267.2 KB
Charge

Submit customer card details

Use this endpoint to submit the customers card details

post/v1/checkout/checkout-card-detail

Request body

cardDetailsstring

Stringified card details

keystring

encryption key is data encrption is in use, else empty string

orderReferencestring

the order reference returned when the order was created

saveCardboolean

if true, this this user cardn will be saved for the user's future use. Note the process is not complete until the user-card verification endpoints are called to authenticate the user's phone number.

Example request

{
  "orderReference": "c4307d58-2513-41d8-b7f7-dfecd5f9fdbe",
  "deviceInformation": {
    "httpBrowserLanguage": "en-GB",
    "httpBrowserColorDepth": "30",
    "httpBrowserScreenHeight": "900",
    "httpBrowserScreenWidth": "1500",
    "httpBrowserTimeDifference": "-60",
    "userAgentBrowserValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
    "deviceChannel": "Browser"
  }
}

Response

OK - your request was successful.

codestring required

Response Code

descriptionstring required

Response description

Example response

{
  "code": "00",
  "description": "Success",
  "data": {
    "message": "Success",
    "responseCode": "00",
    "transactionId": "c4307d58-2513-41d8-b7f7-dfecd5f9fdbe",
    "secureAuthenticationData": {
      "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
      "md": "6775843012",
      "acsUrl": "https://ip:port/merchant.com/callback",
      "termUrl": "https://ip:port/merchant.com/callback"
    }
  }
}