Skip to main content
POST
Request Payment
Initiate a payment request that requires user approval in the mobile app. The payment request is stored in Redis and expires after 5 minutes. Users receive a real-time notification via WebSocket.

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"