Payment Status Mock (only sandbox testnet)

HTTP Request

POST /v5/bybitpay/pay_status_mock

Request Parameters

Parameter	Required	Type	Comments
merchantId	true	string	Onboarding merchant UID
clientId	false	string	Merchant client ID
paymentType	true	string	Payment type E_COMMERCE: Bybit QR Pay for e-commerce E_COMMERCE_REFUND: Bybit QR Pay refund for e-commerce
merchantTradeNo	false	string	"paymentType"=E_COMMERCE: it is merchant order number; "paymentType"=E_COMMERCE_REFUND: it is merchant refund order number required if "payId" is not provided
payId	false	string	"paymentType"=E_COMMERCE: it is Bybit pay ID; "paymentType"=E_COMMERCE_REFUND: it is Bybit refund ID required if "merchantTradeNo" is not provided
status	true	string	Order status

Response Parameters

Parameter	Type	Comments
order	<PayOrderType>	Bybit PayOrder Detail

Response Example

{
    "retCode": 100000,
    "retMsg": "success",
    "result": {
        "order": {
            "merchantId": "305142568",
            "clientId": "",
            "paymentType": "E_COMMERCE",
            "merchantTradeNo": "fe43f6b0-fb6c-4f17-af07-d069746ec760",
            "payId": "01JN5WJNK8ZYK8B7JGKTVNXCPN",
            "status": "PAY_SUCCESS",
            "amount": "100",
            "currency": "USDT",
            "currencyType": "crypto",
            "createTime": 1740733241,
            "paymentTime": 0,
            "finishTime": 0,
            "refundOrders": []
        }
    }
}