Card Payment

Payment with Card

Process Card Request URL

https://api.pelpay.ng/Payment/process/card/:adviceReferenceapi.pelpay.ng

Request Body

{
  "cardNumber": "5200000000001096",
  "expiredMonth": "12",
  "expiredYear": "2050",
  "cvv": "111",
  "cardPin": "1234",
  "shouldSaveCard": true
}

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

Response Code Description

Code	Description
200	Success
400     Bad Request

Response Body

{
  "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"
}

Complete Card Payment

Comple Card Request URL

https://api.pelpay.ng/Payment/complete/cardapi.pelpay.ng

Request Body

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

Response Code Description

Code	Description
200	Success
400     Bad Request

Response Body

{
  "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"
}