Pay with mobile money

The endpoint /v1/payment/pay/:payment_reference is a POST request that initiates a mobile money payment. The request body should be in raw format and include the following parameters:

POST: v1/payment/pay/:payment_reference

Params

Name
Type
Description

payment_reference

string

The payment reference that was generated when initializing payment

Headers

Name
Type
Description

secret-key

string

Your Vesicash secret key

public-key

string

Your Vesicash public key

Request body

  • currency (string): The currency for the payment.

  • country (string): The country for the payment.

  • narration (string): Description or reason for the payment.

  • method (string): The payment method to be used.

  • amount (number): The amount of the payment.

  • customer_first_name (string): The first name of the customer.

  • customer_last_name (string): The last name of the customer.

  • account_number (string): The customer's account number.

Request

For example, you can make a post request to the endpoint above and pass in the raw json data below to create a one-off transaction.

{
    "email":"",
    "customer_first_name":"segun",
    "customer_last_name":"ige",
    "customer_city":"ikorodu",
    "account_number":"",
    "phone_number":"",
}

Response

{
    "status": "success",
    "code": 200,
    "message": "success",
    "data": {
        "payment_link": "",
        "reference": "",
        "payment_id": "",
        "status": "pending"
    }
}

Last updated