Integration Guide (Must Read)

This page provides detailed information on platform integration public parameters, signature algorithms, multi-language configuration, common error codes, and other specifications. Please read this page carefully before integration.

Merchant Notice

• Server timezone: UTC timezone, merchants need to pay attention to timezone calculations for data statistics

• The provided interfaces include isSuccess=true to indicate success, along with code=0. The code will return different error codes for different interfaces, and message will return corresponding error information in the local language

• The token returned by the platform is valid for seven days. After seven days, you need to obtain a new token

• After approval of account opening requirements, we will provide merchant backend account. Merchants can view tenant_id (merchant ID) and secret (signature key) through the backend

• {API_URL_ROOT} in the documentation needs to be replaced with the test/production environment interface call address provided in the merchant backend interface

Public Parameters

All interface calls must include the following parameters

Note: Case sensitive

Signature Algorithm

sign=md5(signature key secret + json string in body + signature key secret)

Note: The order of each field and data type when generating json must be consistent with the documentation, otherwise the encrypted signature cannot be recognized

Example

Call User Registration to generate signature

Registration interface parameters：

{
  "tenantId": 1,
  "userId": "t1_276682",
  "nickName": "千叶",
  "balance": 10304.00,
  "currency": "BRL"  
}

Compose signature string： 39a6581c31ef3203a22edb2daa2ab6d1{"tenantId":1,"userId":"t1_276682","nickName":"千叶","balance":10304.00,"currency":"BRL"}39a6581c31ef3203a22edb2daa2ab6d1

Interface Return Structure

All interfaces return Content-Type as "application/json; charset=utf-8"

Example

{
  "isSuccess": true,
  "code": 0,
  "data": "67d2952e5011e3ca91c2b827"
}