Charge

POST

https://devapi.collect.africa/payments/charge

Last modified:2025-04-19 09:05:16

Charge for a payment

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "email": "test@gmail.com",
    "amount": 15000,
    "reference": "12345",
    "public_key": "string",
    "type": "ng_bank_transfer"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://devapi.collect.africa/payments/charge' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "test@gmail.com",
    "amount": 15000,
    "reference": "12345",
    "public_key": "string",
    "type": "ng_bank_transfer"
}'

Responses

🟢200OK

application/json

200

Body

Example

{
    "message": "Checkout Initialized",
    "data": {
        "id": 8729,
        "amount": 10000,
        "code": "SC_ckyahqvds000x01qg8eeg5nhe",
        "customer_id": 7,
        "first_name": "peter",
        "middle_name": null,
        "last_name": "parker",
        "email": "peterparker@gmail.com",
        "business_id": 1,
        "business_name": "Prod Company",
        "currency": "NGN",
        "country": "NG",
        "reference": "1641928346571",
        "callback_url": null,
        "pass_fee": false,
        "payment_methods": [
            {
                "name": "ng_bank_transfer",
                "charge_percentage": 1,
                "charge_cap": 50000
            },
            {
                "name": "ng_card",
                "charge_percentage": 1.5,
                "charge_cap": 200000
            },
            {
                "name": "ng_opay_wallet",
                "charge_percentage": 1,
                "charge_cap": 50000
            },
            {
                "name": "ng_barter",
                "charge_percentage": 1.4,
                "charge_cap": 200000
            }
        ]
    }
}

🟠400Bad Request

Modified at 2025-04-19 09:05:16

Create PayLink

Payment Initialize