Pay with card

This endpoint allows you to initiate a payment with the provided details.

The endpoint {{redstone-api}}/v1/payment/pay/:payment_reference is a POST request that initiates a card 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 Redstone secret key

public-key

String

Your Redstone public key

Request body

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

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

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

  • method (string): The payment method, in this case "card".

  • phone_number (string): The phone number of the customer.

  • email (string): The email address of the customer.

  • token(string): The context token generated from the payment context.

  • frquency(string): The frequency of the payment, e.g., "monthly".

  • customer_address(string): The address of the customer.

  • customer_country(string): The country of the customer.

  • customer_city (string): The customer's city.

  • customer_state(string): The state of the customer.

  • customer_zip(string): The ZIP code of the customer.

Request

For example, you can make a post request to the endpoint above and pass in the raw json data below to make payment with card

{
    "account_number": "260******", 
    "customer_first_name": "Efemena",
    "customer_last_name": "Elvis",
    "method": "card",
    "phone_number": "260********",
    "email": "[email protected]",
    "token": "",
    "frquency": "monthly", //monthly,quartely,bi-annual, annually
    "customer_address": "test address",
    "customer_country": "ZM",
    "customer_city": "Lusaka",
    "customer_state": "Lusaka",
    "customer_zip": "10101"
}

Response

{
    "status": "success",
    "code": 200,
    "message": "success",
    "data": "payment sent for processing"
}

Last updated