INinterswitchgroup

Do Payment

This endpoint is provided as a proxy for clients who will like to collect payments from a user using their payment token. The API will send a request for a debit of a specified amount through IPG.

post/lending-service/api/v1/payments

Request

  • Base URL
    https://sandbox.interswitchng.com
  • URL
    https://sandbox.interswitchng.com/lending-service/api/v1/payments
  • Auth
    none required

Headers

Authorizationstring

Request body

customerIdstring required

The Email or Mobile Number of the User. Max length: 50

tokenstring required

The Payment Token of the user generated by Vault. Max length: 20

amountstring required

The Amount to be debited from the user’s payment card. (This is in lower denomination KOBO). Max length: 20.

providerCodestring required

The Code of the Provider/Client from which the request is coming from. Max Length: 50

currencyCodestring required

The Code of the currency of the Amount to be debited. E.g 566. Max Length: 3

transactionIdstring required

The unique transaction identifier. Max Length: 50

tokenExpiryDatestring

Response

200

responseCodestring
responseDescriptionstring
transactionRefstring

Example response

{
  "responseCode": "00",
  "responseDescription": "Successful",
  "transactionRef": "UBN|WEB|ILS|20170501120945|0198849"
}

Changes

No recorded changes to this operation across all 1 revision of this API.