Skip to main content
POST
/
wallet
/
request-payment
Request Payment
curl --request POST \
  --url https://api.changu.app/api/v1/wallet/request-payment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "walletId": "wallet_id_here",
  "amount": 1000,
  "description": "Payment for service XYZ",
  "merchantName": "ACME Corporation"
}
'
{
  "success": true,
  "message": "Payment request sent to user for approval",
  "paymentRequestId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING",
  "expiresAt": "2026-01-22T17:30:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication using developer secret key. Format: Bearer sk_live_your_secret_key_here

Body

application/json
​
walletId
string
required

Wallet ID obtained from the get account endpoint

Example:

"wallet_id_here"

​
amount
number<double>
required

Amount to charge (minimum 0.01)

Required range: x >= 0.01
Example:

1000

​
description
string
required

Description of the payment

Example:

"Payment for service XYZ"

​
merchantName
string
required

Merchant/company name for display in the payment request

Example:

"ACME Corporation"

Response

Payment request created successfully

​
success
boolean
required
Example:

true

​
message
string
required
Example:

"Payment request sent to user for approval"

​
paymentRequestId
string<uuid>
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
status
enum<string>
Available options:
PENDING
Example:

"PENDING"

​
expiresAt
string<date-time>
Example:

"2026-01-22T17:30:00.000Z"