Native Checkout Integration

Users can scan the QR code or copy the address on the checkout page built on your sites/apps to make the payments.

Integrate with Native Checkout API to build the checkout page for your sites/apps. Users pay in your sites/apps. No need to lead them to external pages. Take complete control of your users' checkout experience.

Step 1: Create Payment Order

Submit payment order and receive payment address

POST https://pay.reelpay.com/v1/transactions/pay

Return receiving address/QR code and order information

Headers

Name	Type	Description
X-Sign*	String	hmacSHA256 (body (json string)+timestamp+appKey). Signature guide.
X-Timestamp*	String	Timestamp in seconds (10-digit). The request is valid for two minutes.
X-Appid*	String	Merchant's unique credential. Find it on the AppManage page.
content-type*	String	application/json

Request Body

Name	Type	Description
out_trade_no*	String	Order ID in Merchant's system. A unique ID for every order
currency_id*	String	Currency ID.
fiat_name*	String	Fiat name (USD)
fiat_amount*	String	Fiat amount (1.2)

200: OK Success (200)/Fail (200)

Success (200)

Response (Success 200)

Header

Name	Value	Required	Type	Description
X-Appid	el9q0mzllpjhducy	Y	String	Merchant's unique credential. Find it on the AppManage page.
X-Timestamp	1677152490	Y	String	Timestamp in seconds (10-digit). The request is valid for two minutes.
X-Sign	e0b78d93fd702aa31b07d5488cd85b4b7176d01c4ec45fd8bfaef0d1081a5ead	Y	String	hmacSHA256 (body (json string)+timestamp+appKey). Signature guide.

Body

{
        "code": 200,
        "message": "success",
        "data": {
                "trade_no": "uz54NEW9TVhLSIDHUSYB4aEFupKoE7I8",
                "pay_address": "0x988519e9ba1c147ff687f4b59009d7573c49efed",
                "time_expire": 1673264871,
                "amount": "0.00007971",
                "chain": "Ethereum",
                "token": "ETH",
                "contract": "ETH",
                "decimal": 18
        }
}

Parameters

Name	Value	Required	Type	Description
code	200		Integer
message	success		String
data			Object
data.trade_no	uz54NEW9TVhLSIDHUSYB4aEFupKoE7I8		String	ReelPay order ID
data.pay_address	0x988519e9ba1c147ff687f4b59009d7573c49efed		String	The temporary payment address for current order,only effectivewithin the order validity period.
data.time_expire	1673264871		String	Payment deadline
data.amount	0.00007971		String	The number of tokens that need to be paid
data.chain	Ethereum		String	Chain Name
data.token	ETH		String	Token symbol
data.contract	ETH		String	Token Contract address
data.decimal	18		String	Token decimal

Fail (200)

Remarks

Request Body Example

Request Body

{
  "out_trade_no": "uz54NEW9TVhLSIDHUSYB4aEFupKoE7I8",
  "currency_id": "ZxkanKiq9w2skt7e9CSR4oUX2q9F23LB",
  "fiat_name": "USD",
  "fiat_amount": "1.2"
}

Remark

Step 2: Configure Webhook to receive payout notification

Configure Webhook to receive notifications. ReelPay will notify merchant of the final transaction results. You can configure the Webhook URL on the AppManage page

AppManage

Transactions will start a request to the callback interface set by the merchant when involving the following events:

PAID	Paid
TIME-OUT	Transaction timeout
CLOSE	Transaction closed
REFUND-IN-PROGRESS	Refunding
REFUNDED	Refunded
ABNORMAL	Abnormal transaction
CHAIN-CONFIRMATION-FAILED	Chain confirmation failed

Callback Frequency: 5s、15s、30s、3m、10m、20m、30m、30m、30m、60m、3h、3h、3h、6h、6h

Total: 24h3m50s

Callback Form:

• The callback content is still encrypted.「For more information see the Signature」

Webhook notification

Header

Name	Value	Required	Type	Description
X-Appid	eqrbntqbi5uqvkpr	Y	string	Merchant's unique credential. Find it on the AppManage page.
X-Timestamp	1690368283	Y	string	Timestamp in seconds (10-digit). The request is valid for two minutes.
X-Sign	e0c6a719ebc366da0340c1b450026a903a55c86ed5fbe0b586cd73f6be74ade6	Y	string	hmacSHA256 (body (json string)+timestamp+appKey)
X-EventType	Paid	Y	string	Transaction Status Code

Body

Parameters

Remarks

Merchants sign to ensure information safety. Once the merchant has processed the order, please return "Success" in the body of the HTTP response if the processing has been successful. If the process fails, ReelPay will attempt to send the order again and the Webhook will retry up to 15 times ( Callback Frequency: 5s、15s、30s、3m、10m、20m、30m、30m、30m、60m、3h、3h、3h、6h、6h, Total: 24h3m50s ).

Example