Request Pay Session

POST

/v1/stable/order/pay-session

Use "externalUserId" or "subUserId" from kyb/kyc sharing endpoint to create a pay session with redirect url. If no kyb/kyc info has been share, user will have to fill in detail by themselves after jumping to redirect link.

"externalOrderId" must be uniq, duplicate creation will return same token and will NOT renew the expire time.

Request

Body Params application/json

Example

{
    "amount": 1500.5,
    "currency": "BRL",
    "primaryAccountId": "1234567890123456789",
    "externalUserId": "dinaria-user-uuid-001",
    "subUserId": "sub-user-id-from-share",
    "externalOrderId": "MERCHANT-ORD-2026-0001",
    "remark": "Order ref INV-2026-001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/stable/order/pay-session' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 1500.5,
    "currency": "BRL",
    "primaryAccountId": "1234567890123456789",
    "externalUserId": "dinaria-user-uuid-001",
    "subUserId": "sub-user-id-from-share",
    "externalOrderId": "MERCHANT-ORD-2026-0001",
    "remark": "Order ref INV-2026-001"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "status": 200,
    "code": null,
    "msg": "OK",
    "traceId": "example-trace-id",
    "data": {
        "success": true,
        "amount": 1500.5,
        "currency": "BRL",
        "status": "Initial",
        "failReason": null,
        "expireTime": 1764518400000,
        "totalFee": 1.18,
        "externalUserId": "user-uuid-001",
        "externalOrderId": "MERCHANT-ORD-2026-0001",
        "token": "MockToken",
        "redirectUrl": "https://pay.example.com/checkout?token=MockToken"
    }
}

Mock wallet deposit transaction

Resend Fail Webhook