Initialize Crypto Payment

POST

https://devapi.collect.africa/payments/crypto/initialize

Payments

Last modified:2025-05-05 21:11:17

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

reference

string

required

Unique payment reference

Example:

order_12345

currency

string

required

Currency code in ISO 4217

Example:

USD

coin

enum<string>

required

Stable coin for settlement

Allowed values:

USDTUSDC

chain

enum<string>

required

Blockchain network for settlement

Allowed values:

tronsolanapolygon

amount

number

required

Payment amount (in fiat, equal to stablecoin amount)

Example:

100.5

is_fee_paid_by_user

boolean

optional

Should fee be paid by the users

Example:

false

expires_in_seconds

number

required

Invoice expiration time in seconds

Example:

900

metadata

object

optional

Custom metadata for the payment

Example

{
    "reference": "order_12345",
    "currency": "USD",
    "coin": "USDT",
    "chain": "tron",
    "amount": 100.5,
    "is_fee_paid_by_user": false,
    "expires_in_seconds": 900,
    "metadata": {}
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://devapi.collect.africa/payments/crypto/initialize' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference": "order_12345",
    "currency": "USD",
    "coin": "USDT",
    "chain": "tron",
    "amount": 100.5,
    "is_fee_paid_by_user": false,
    "expires_in_seconds": 900,
    "metadata": {}
}'

Responses

🟢200OK

application/json

Crypto Payment Initialized

Body

message

string

required

data

object

optional

status

string

required

reference

string

required

address

string

required

chain

string

required

expires_at

string

required

amount

number

required

Example

{
    "message": "string",
    "data": {
        "status": "string",
        "reference": "string",
        "address": "string",
        "chain": "string",
        "expires_at": "string",
        "amount": 0
    }
}

🟢201Created

Payment Initialize

Initialize Card Payment