Bank 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

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

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

amount: The amount to charge the customer.
currency Code: 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:

{
    "currencyCode": "GBP",
    "amount": 1,
    "channel": "PayByAccount",
    "currency": "GBP",
    "link": {
        "alias": "0-k2tmbuy"
    },
    "userInformation": {
        "firstName": "Dave",
        "lastName": "MC",
        "emailAddress": "mcdave@test.com",
        "phone": "070000000"
    }
   “metaData”: {
         “return-url”: “https://access.leatherback.co”
       },
}

Channel: An array of payment channels to control what channels you want to make available to the user to make a payment with. Available channels include: ["Card", "PaybyAccount" ]. In this case, you will pass PayByAccount as Channel Value
Amount: The amount to charge the customer for the transaction (Required)
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. E.g NGN=Nigerian Naira, GBP =Great Britain Pounds, etc. (Required)
alias: An alias allows users to access a page (node) or file at an alternative path. A redirect is moving a user to the correct file or page (node) because it no longer exists at a previous path. Alias lets you choose a nickname for your page, meaning a new URL that points to the content the same way the original URL does (This is only Mandatory when initiating a Payment Link transaction)
firstName: This is the first Name of the Customer (Required)
lastName: This is the Last Name of the Customer (Required)
phone: This is the phone number of the Customer (Required)
emailAddress: This is the email address of the customer (Required)

Step 3: Call GET Transaction Status

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

API DOCUMENTATION

Bank Account

Step 1: Call Validate Payment Endpoint

Step 2: Call Initiate Payment Endpoint

Step 3: Call GET Transaction Status

Related articles