Pay by Card (NGN)

Step 1: Call Initiate Payment Endpoint

Title: Initiate Payment

Description: This endpoint is used to initiate a payment transaction irrespective of the channel

URL: https://laas.leatherback.co/api/payment/pay/Initiate

First, you need to gather the transaction and Customer details as shown below

{
   "amount": 1,
   "channel": "Card",
   "currency": "NGN",
   "narration": "--", // Optional
   "reference": "string", // Optional
   "userInformation": {
       "firstName": "ogr",
       "lastName": "et",
       "phone": "08100969815",
       "emailAddress": "etog@gmail.com"
   },
   "paymentRequestProps": {
       "card": {
           "cvv": "100",
           "expMonth": 1,
           "expYear": 2039,
           "number": "4508750015741019"
       }
   },
   "metaData": {
       
   }
}

Element	Description	Type	Example	Required
`Channel`	An array of payment channels to control what channels you want to make available to the user to make a payment with. In this case, you will Card as Channel Value	String \| ENUM	Card	Yes
`amount`	Transaction Amount to be sent	Float \| Integer, Must be greater or equal to 1.00, 2 Decimal places	100, 100.20	Yes
`reference`	This is your unique transaction ID. If you do not pass your reference, the system will generate one for you	String max length: 20 characters	JBL450696789	No
`currencyCode`	Currency Code for the transaction which is NGN	String, 3 digits	NGN	Yes
`narration`	Description for transaction, which user will see	String, max length: 100 characters	“Payment for lunch”	No
`firstName`	This is the first Name of the Customer	String	Long	Yes
`lastName`	This is the Last Name of the Customer	String	Island	Yes
`emailAddress`	This is the email address of the customer	String		Yes
`phone`	This is phone number of the Customer	String	08123456789	Yes
`metadata`	An object containing any extra information you'd like to store alongside the transaction		`"metaData": { }`	Yes
`return-url`	This is a string that would be redirected to as soon as there is a transaction status when the 3ds validation is done			Yes

{
   "value": {
       "paymentStatus": "INITIATED",
       "requiresAction": true,
       "message": "Payment Initiated Successfully",
       "bankAuthURL": null,
       "paymentItem": {
           "channel": "Card",
           "message": "Payment Initiated Successfully",
           "totalAmount": 1200,
           "amount": 1200,
           "fees": 0,
           "reference": "LIZQNS6DJAL7G38SPG",
           "paymentReference": "LIZQNS6DJAL7G38SPG",
           "metaData": {
               "AuthUrl": "https://pay.leatherback.co/mastercard?client_url=https://access.leatherback.co&lb_reference=LIZQNS6DJAL7G38SPG&redirect=true”"
           }
       }
   },
   "isSuccess": true,
   "error": "",
   "message": "",
   "type": null,
   "title": null,
   "status": null,
   "detail": null,
   "instance": null
}

Step 2: Call GET Transaction Status

Test Cards	Card Number	CVV	3-D Secure Enrolled

Test Cards	Card Number	CVV	3-D Secure Enrolled
Mastercard	5123450000000008	100	Y
	2223000000000007		Y
	5111111111111118		N
	2223000000000023		N
VISA	4508750015741019	100	Y

API DOCUMENTATION

Pay by Card (NGN)

Analytics

Step 1: Call Initiate Payment Endpoint

Step 2: Call GET Transaction Status

Related content