PaymentLink Notification

Webhook

POST

paymentLinkStatusUpdate

Webhook Status Flow

One-Time Payments

init -> active -> processing -> completed, or active -> expired.

Permanent Payment Links

Parent link: created -> active -> remains active and reusable.

Each payment: payment matched -> child payment record (paymentId, referencePaymentId) -> processing -> completed.

A child becomes completed only after all required merchant fund transfers succeed.

No order-status notification is emitted only for entering processing; completion is notified when the child becomes completed.

Request

Header Params

Body Params application/json

Example

{
    "eventId": "string",
    "eventType": "PAYMENT_LINK_UPDATED",
    "timestamp": 0,
    "data": {
        "paymentId": "string",
        "referencePaymentId": "sample_parentPaymentId",
        "requestId": "sample_requestId",
        "userOrderNo": "string",
        "productRemark": "string",
        "recipientName": "string",
        "recipientAccountId": "string",
        "fiatCurrency": "string",
        "fiatAmount": "string",
        "cryptoCurrency": "string",
        "cryptoAmount": "string",
        "quotePrice": "string",
        "supportCurrency": "string",
        "supportNetwork": "string",
        "payerInfo": {
            "payerNameUnavailable": true
        },
        "returnUrl": "http://example.com",
        "status": "init",
        "paymentLinkType": "permanent",
        "paymentValidTime": 1,
        "paymentLink": "http://example.com",
        "effectiveTime": 0,
        "expiresTime": 0,
        "createTime": 0
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'API-KEY: <api-key>' \
--header 'API-SIGNATURE: <api-key>' \
--header 'API-TIMESTAMP: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "eventId": "string",
    "eventType": "PAYMENT_LINK_UPDATED",
    "timestamp": 0,
    "data": {
        "paymentId": "string",
        "referencePaymentId": "sample_parentPaymentId",
        "requestId": "sample_requestId",
        "userOrderNo": "string",
        "productRemark": "string",
        "recipientName": "string",
        "recipientAccountId": "string",
        "fiatCurrency": "string",
        "fiatAmount": "string",
        "cryptoCurrency": "string",
        "cryptoAmount": "string",
        "quotePrice": "string",
        "supportCurrency": "string",
        "supportNetwork": "string",
        "payerInfo": {
            "payerNameUnavailable": true
        },
        "returnUrl": "http://example.com",
        "status": "init",
        "paymentLinkType": "permanent",
        "paymentValidTime": 1,
        "paymentLink": "http://example.com",
        "effectiveTime": 0,
        "expiresTime": 0,
        "createTime": 0
    }
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{}

partner order status

Deposit Whitelist Notification