POST
/
charge
curl --location --request POST 'https://api.recital.finance/charge' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "reference": "O8UXZUS4SRKB723KEPSIEUBTBWHZVR",
    "payment_type": "CHECKOUT",
    "first_name": "cleopatra",
    "last_name": "douglas",
    "email": "cleo@gmail.com",
    "currency": "NGN",
    "phone": "",
    "amount": 600,
    "payment_methods": [],
    "product": {
        "name": "gold test",
        "description": "This is a gold test payment"
    }
}'

{
    "message": "success",
    "success": true,
    "data": {
        "payment_type": "CHECKOUT",
        "transaction": {
            "paymentLink": "https://devy.recital.finance/pay/?mask=XITPTOCMIMX9XFIJJYK63PEWQKLHEL"
        }
    }
}

​
Body

​
reference
string
required

This is a unique reference peculiar to the transaction being carried out.

​
first_name
string

This is customers’ first name.

​
last_name
string

This is customers’ last name.

​
phone
string

This is customers’ phone number.

​
amount
number
required

This is the amount to be charged for the transaction.

​
email
string
required

This is the email address of the customer.

​
currency
string
required

This is the specified currency to charge in.

​
redirect_url
string
required

This is a url you provide, we redirect to it after the customer completes payment and append the response to it as query parameters. (3DSecure only).

​
payment_methods
list

The payment options to be displayed. See Payment methods.

​
product
json
​
payment_type
string
default:
"CHECKOUT"

CHECKOUT

​
Response

​
success
boolean

Indicates whether the call was successful. true or false.

​
message
string

Holds reason for failure or a success message.

​
data
json
curl --location --request POST 'https://api.recital.finance/charge' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "reference": "O8UXZUS4SRKB723KEPSIEUBTBWHZVR",
    "payment_type": "CHECKOUT",
    "first_name": "cleopatra",
    "last_name": "douglas",
    "email": "cleo@gmail.com",
    "currency": "NGN",
    "phone": "",
    "amount": 600,
    "payment_methods": [],
    "product": {
        "name": "gold test",
        "description": "This is a gold test payment"
    }
}'

{
    "message": "success",
    "success": true,
    "data": {
        "payment_type": "CHECKOUT",
        "transaction": {
            "paymentLink": "https://devy.recital.finance/pay/?mask=XITPTOCMIMX9XFIJJYK63PEWQKLHEL"
        }
    }
}
Errors