Skip to content

Pay-in callback

VellPay sends this callback to the pay-in callback URL supplied when the order was created or configured in the merchant console. You do not need to call the VellPay API.

Request headers

Callback request headers.

Request parameters

FieldTypeRequiredMaximum lengthDescription
merchantOrderNoStringYes32Merchant order number
tradeNoStringYes32Platform order number
paymentSingleOrderNoStringYes32Single payment transaction number
paymentAmountStringYes-Actual received amount, an integer or up to two decimal places
paymentTypeStringYes24Payment method
paymentStatusStringYes24Order status
failMsgStringNo200Order failure reason
paymentInfoStringNo200Payment information
serviceAmountStringNo-Service fee
completeTimeStringYes-Completion time (local time, format yyyy-MM-dd HH:mm:ss)

Request example

{
"merchantOrderNo": "ORDER202609170001",
"tradeNo": "VS2608270002AR0000000000040059",
"paymentSingleOrderNo": "PS20260917000001",
"paymentAmount": "100.00",
"paymentType": "QR",
"paymentStatus": "SUCCESS",
"serviceAmount": "1.00",
"completeTime": "2026-09-17 15:30:00"
}

Response parameters

FieldTypeRequiredExampleDescription
resultStringYesSUCCESSReturn SUCCESS to acknowledge successful receipt; any other value is treated as a failure
msgStringNoOKProcessing result description

Response example

{
"result": "SUCCESS",
"msg": "OK"
}