Sign in

v1

latestOpenAPI 3.0.12026-07-225791279.7 KB
Card Collection

Card Charge

This endpoint is used to initiate Card payments for merchants that use our platform. This document has various Request bodies and HTML text that are necessary for different integration purposes. See the full Cards guide for a step-by-step walkthrough.

Note:

  • The Card Acquirer Response Codes with descriptions can be found <a href="https://docs.google.com/spreadsheets/d/13AmGYgpGxEVNMnTtvBYg_NZaHaBbcp9ZbSfzhR-1ft4/edit?usp=sharing" target="_blank">here</a>
  • Please be advised that card collections to countries other than Nigeria are exclusively available upon request. To initiate this process, kindly send an email to <b>support@payaza.africa</b>. You will be granted access once our team reviews and approves your request.
post/card/card_charge/

Request body

Example request

{
  "service_payload": {
    "first_name": "John",
    "last_name": "Doe",
    "email_address": "johndoe@hotmail.com",
    "phone_number": "0939344401",
    "amount": 0.01,
    "transaction_reference": "T13501973673737",
    "currency": "USD",
    "description": "TEST",
    "card": {
      "expiryMonth": "10",
      "expiryYear": "26",
      "securityCode": "686",
      "cardNumber": "4865550017193640",
      "pin": "1234"
    },
    "callback_url": "https://callbackurl.com"
  }
}

Response

Card Charge Responses

OR
OR

Example response

{
  "statusOk": true,
  "message": "Authentication Required",
  "debugMessage": "3DS Authentication Required",
  "do3dsAuth": true,
  "formData": "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjQ5ZGJ...",
  "threeDsHtml": "<div id='threedsChallengeRedirect'> ... </div>"
}