Topup a Card

Initiate a card top-up by transferring funds from your Pagsmile Issuing account.

Request URI

POST /issuing/card/recharge

Request Body

Refer to : common

Biz_data :

Name	Type	Description
pay_account_num*	string(48)	Payer Account Number
card_token*	string(20)	Card Token
order_no*	string(32)	Order Number.Globally unique
amount*	String	Topup amount.Refer to : unit
currency*	string(3)	A 3-letter ISO currency code
reference	string(128)	Reference

Request Example

{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "sub_partner_id": "",
    "request_id": "E7E15DeE-B6d9-578B-6968-7dF7bB8c",
    "timestamp": "2025-04-07 13:56:52",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "card_token": "450620141926",
        "order_no": "fE2E44c2-A4cF-C4Fc-40d6-Ee493262",
        "pay_account_num": "104190000004",
        "amount": "1.23",
        "currency": "USD",
        "reference": "remark"
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!

Response

Name	Type	Description
transaction_id	string	Transaction ID

200:OK

{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": {
        "transaction_id": "100000076795"
    }
}
// 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"
}