Hosted Checkout Page Integration

Users can scan the QR code or copy the address on the hosted checkout page to make the payments.

We recommend merchants to integrate with ReelPay's hosted checkout interface. You will only need two steps to start accepting crypto payments. When the integration is done. Your server will be able to call the checkout URL API and present ReelPay's hosted checkout page to your users.

Step 1: Get Checkout URL

Return a Checkout URL

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

Headers

NameTypeDescription

X-Appid*

String

Merchant's unique credential. Find it on the AppManage page.

X-Timestamp*

String

Timestamp in seconds (10-digit). The request is valid for two minutes.

X-Sign*

String

hmacSHA256 (body (json string)+timestamp+appKey). Signature guide.

content-type*

String

application/json

Request Body

NameTypeDescription

symbol*

String

Amount should be paid for this order (in USD by default, no more than two digits after the dot)

out_trade_no*

String

Order ID in Merchant's system

name*

String

Name of the product

image

String

The URL address of the product image

amount

String

Product Price

Response

NameValueRequiredTypeDescription

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.

content-type

application/json

Y

string

Body

{
    "code": 200,
    "message": "success",
    "data": {
        "url": "https://pay.reelpay.com/b79d2586ef7807d18c20230725183439",
        "time_expire": 1690389279,
        "trade_no": "b79d2586ef7807d18c20230725183439"
    }
}

Parameters

NameValueRequired TypeDescription

code

200

Integer

message

success

String

data

Object

data.url

String

URL link of payment

data.time_expire

1690389279

Integer

data.trade_no

b79d2586ef7807d18c20230725183439

String

ReelPay Order ID

Request Body Example

{
    "out_trade_no":"202307250001",
    "symbol":"USD",
    "amount":"100",
    "name":"product name",
    "image":"https://reelpay.com/product.jpg"
}

SDK Example

import (
    reelpay "github.com/ReelPayment/sdk-go"
)
func main()  {
    transaction := reelpay.Transactions{
        AppID: "eqrbntqbi5uqvkpr",
        AppKey: "XhAlbICW10VJnWGruPL0NSnvb6946JDQ",
    }
    res := transaction.EntrustPay(&reelpay.EntrustPay{
        OutTradeNo: "jSWfrolOTdsadcYuUwkJbdw9IJUBeV",
        Symbol:     "USD",
        Amount:     "1.2",
        Name:       "Product name",
        Image:      "https://reelpay.com/product.jpg",
    })
    fmt.Println(res)
}

Click me to see more

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

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

  • Paid

  • Transaction close

  • Transaction timeout

  • Refunded

  • 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

NameValueRequiredTypeDescription

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

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

Last updated