Create Deposit Order

To add funds to your issuing account balance:

1. Initiate a bank transfer from your financial institution

2. Provide your bank transfer details via this API

3. Funds will be credited to your balance upon receipt

Request URI

POST /issuing/partner/create-topup

Request Body

Refer to : common

Biz_data ：

Name	Type	Description
order_no*	string	Order Number
pay_amount*	string	Amount
pay_currency*	string	Currency Refer to : currency
topup_account_num	string	Top-up Account Number
topup_currency*	string	Top-up Currency Refer to : currency
reference	string	Reference
payment.account_num	string	Bank payer account num/IBAN
payment.bank_name	string	Payer Bank Name
payment.arrive_date	string	Expected time of receipt

Request Example

{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "sub_partner_id": "",
    "request_id": "E74B6dda-c1cD-D7dd-aD52-6c5DdFc2",
    "timestamp": "2025-04-07 13:57:01",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "order_no": "7DFEfCd2-3cEA-D757-cBA9-b7DceA4c",
        "pay_amount": "48",
        "pay_currency": "USD",
        "topup_currency": "HKD",
        "reference": "reference",
        "payment": {
            "account_num": "45679876545678876",
            "bank_name": "Test Bank name",
            "arrive_date": "2024-10-12"
        }
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!

Response

Name	Type	Description
order_id	long	Order Id

200:OK

{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": {
        "order_id": 101535
    }
}
// The data in this example has already been decrypted.

400: invalid-signature

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}