Card Payment

Process Card Payment

POST /api/process/card/:adviceReference

Process a Card Payment

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Ensure to pass the cardPin for verve Cards (It is required) 
cardPin property can be ignored for other card types 

{
  "cardNumber": "5399839222071010",
  "expiredMonth": "12",
  "expiredYear": "2024",
  "cvv": "123",
  "cardPin": "123456",
  "shouldSaveCard": true
}

Response

200

{
  "requestSuccessful": true,
  "responseData": {
    "merchantCode": "Nai0000319",
    "paymentReference": "487b4d9f733f4464a35700e5767dreut",
    "merchantReference": "13277654324537993",
    "amountCollected": 100,
    "amount": 100,
    "callBackUrl": "https://your_callback_url.com/?adviceReference=eced58f4-c187-4f3c-8482-062cde424r5t&paymentReference=487b4d9f733f4464a35700e5767dreut",
    "transactionStatus": "AuthSetup",
    "currencyCode": "NGN",
    "accountNumber": "95782a0826b00e0917f40deadb36f7142fcfd520162780b3513441c5b6e440d6",
    "accountNumberMasked": "5200*****0007",
    "narration": "test",
    "env": "Test",
    "message": "COMPLETED",
    "formData": {
      "url": "https://centinelapistag.cardinalcommerce.com/V1/Cruise/Collect",
      "formData": {
        "JWT": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwMDY5NWQzOS01ZTYxLTQyYjgtYTVmYS1iNjc4NjdhNDA0OWMiLCJpYXQiOjE3MDg1MjQwMDAsImlzcyI6IjVkZDgzYmYwMGU0MjNkMTQ5OGRjYmFjYSIsImV4cCI6MTcwODUyNzYwMCwiT3JnVW5pdElkIjoiNjBiMGRiOWY0ODk3ZDk2YTRlZWZiZmQxIiwiUmVmZXJlbmNlSWQiOiIzZDAyMDhjYy1hYTY2LTQ4ZGEtOTJmMS1kNTIxNDE1M2IzM2MifQ.14pNQ-40HvJ2p-DI9d3M3qYl3GoQjMJj558pKnzp5rw"
      },
      "formString": "<form id=\"ddc-form\" target=\"ddc-iframe\" method=\"POST\" action=\"https://centinelapistag.cardinalcommerce.com/V1/Cruise/Collect\" ><input type = \"hidden\" name = \"JWT\" value =\"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwMDY5NWQzOS01ZTYxLTQyYjgtYTVmYS1iNjc4NjdhNDA0OWMiLCJpYXQiOjE3MDg1MjQwMDAsImlzcyI6IjVkZDgzYmYwMGU0MjNkMTQ5OGRjYmFjYSIsImV4cCI6MTcwODUyNzYwMCwiT3JnVW5pdElkIjoiNjBiMGRiOWY0ODk3ZDk2YTRlZWZiZmQxIiwiUmVmZXJlbmNlSWQiOiIzZDAyMDhjYy1hYTY2LTQ4ZGEtOTJmMS1kNTIxNDE1M2IzM2MifQ.14pNQ-40HvJ2p-DI9d3M3qYl3GoQjMJj558pKnzp5rw\"  /></form>"
    },
    "returnUrl": "http://178.62.116.233:84/payment/card/webhook?adviceReference=eced58f4-c187-4f3c-8482-062cde421r4t&paymentReference=487b4d9f733f4464a35700e5767dreut",
    "customerName": "Chams Switch",
    "paymentDate": "2024-02-21T14:59:59.8303242+01:00"
  },
  "message": "Successful",
  "responseCode": "00"
}

400

{
  "error": "Invalid request"
}

Complete Card Payment

POST /api/complete/card

Complete a Card Payment

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

{
  "paymentreference": "487b4d9f733f4464a35700e5767dreut",
  "value": "123456"
}

Response

200

{
  "requestSuccessful": true,
  "responseData": {
    "merchantCode": "Nai0000319",
    "paymentReference": "487b4d9f733f4464a35700e5767ddceb",
    "merchantReference": "13277654324537993",
    "amountCollected": 100,
    "amount": 100,
    "callBackUrl": "https://your_callback_url.com/?adviceReference=eced58f4-c187-4f3c-8482-062cde421f6c&paymentReference=487b4d9f733f4464a35700e5767ddceb",
    "processorCode": "00",
    "transactionStatus": "Successful",
    "currencyCode": "NGN",
    "accountNumber": "95782a0826b00e0917f40deadb36f7142fcfd520162780b3513441c5b6e440d6",
    "accountNumberMasked": "5200*****0007",
    "narration": "test",
    "env": "Test",
    "message": "Successful",
    "returnUrl": "http://178.62.116.233:84/payment/card/webhook?adviceReference=eced58f4-c187-4f3c-8482-062cde421f6c&paymentReference=487b4d9f733f4464a35700e5767ddceb",
    "customerName": "Chams Switch",
    "paymentDate": "2024-02-21T14:59:59.830324+01:00"
  },
  "message": "Successful",
  "responseCode": "00"
}

400

{
  "error": "Invalid request"
}