POST
/
payments
/
initiate
Initiate Payment Checkout
curl --request POST \
  --url https://business-api.userivo.co/business/v1/payments/initiate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 50000,
  "currency": "NGN",
  "customer": {
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "reference": "my_custom_ref_123",
  "redirectUrl": "https://example.com/payment-success"
}
'
{
  "status": "success",
  "message": "Payment link created successfully",
  "data": {
    "reference": "my_custom_ref_123",
    "code": "abc123def456",
    "link": "https://payment.userivo.co/checkout/abc123def456"
  }
}

Authorizations

Authorization
string
header
required

Your Business API Key

Body

application/json
amount
number
required
Example:

50000

currency
string
required
Example:

"NGN"

customer
object
required
reference
string
Example:

"my_custom_ref_123"

redirectUrl
string
Example:

"https://example.com/payment-success"

Response

200 - application/json

Payment checkout initiated successfully.