Pay by Account

GBP Bank Account Integration Process

Currently, on the Leatherback Platform, This payment method is only supported in GBP Currency. The process below can be followed to integrate the GBP Bank Account ;

Step 1: Call Validate Payment Endpoint

Title: Validate Payment

Description: This endpoint gives the available payment channel available for a given currency

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

First, you need to gather and Pass on the details below.

{
  "amount": {
    "currencyCode": "GBP",
    "amount": 20
  },
  "channels": [
    "string"
  ]
}

amount: The amount to charge the customer.
currencyCode: A three-letter ISO code for the currency you want to accept the payment. A unique code that represents a defined business currency. E.g NGN=Nigerian Naira, GBP =Great Britain Pounds

{
  "value": {
    "isValid": true,
    "channels": [
      {
        "id": "2d60ca92-8f2f-486a-aa21-35cc9434898f",
        "name": "Card",
        "alias": "Card",
        "description": null
      },
      {
        "id": "a470390f-4d10-4a9b-922b-8fd960b4b595",
        "name": "PayByAccount",
        "alias": "PayByAccount",
        "description": null
      }
    ]
  },
  "isSuccess": true,
  "error": "",
  "message": "Request Successful",
  "type": null,
  "title": null,
  "status": null,
  "detail": null,
  "instance": null
}

Step 2: Call Initiate Payment Endpoint

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

{
    "channel": "PayByAccount",
    "amount": 20,
    "currency": "GBP",
    "narration": "test redirect",
    "reference": "XXZU9HJ93F",
    "userInformation": {
        "firstName": "John",
        "lastName": "Doe",
        "phone": "07843094834",
        "emailAddress": "test@gmail.com"
    },
    "paymentRequestProps": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
    },
    "metaData": {
        "return-url": "https://test.co"
    }
}

Element	Description	Type	Example	Required
Channel	This is the channel in which this payment will be processed NB The available channels vary by the currency selected. To see a list of channels available to you, use the Validate Payment endpoint.	String	["PayByAccount" ]	Yes
amount	The amount to charge the customer for the transaction	String	100	Yes
currencyCode	A three-letter ISO code for the currency in which you want to accept the payment. A unique code that represents a defined business currency.	string	GBP	Yes
narration	This is usually a description of items being purchased by a customer	string	Payment for goods	No
reference	This is a unique alphanumeric code that identifies a payment.	string	`"XXZU9HJ93F"`	Yes
firstName	This is the first Name of the Customer	string	John	Yes
lastName	This is the last Name of the Customer	string	Doe	Yes
phoneNumber	This is the phone number of the Customer	string	`"07843094834"`	Yes
emailAddress	This is the email address of the customer	string	`"test@gmail.com"`	Yes
metaData	This contains your return URL that you will be redirected to once a transaction is completed	object		Yes

Step 3: Call GET Transaction Status

Pass the Payment Reference: "TLUKHPC0J7A1OMRPPG" from the response gotten from the Initiate Payment End point above