API Mobile Topup
Endpoint: /api/v1/service/topup/charging
Method: POST
Header: How to generate JWT_TOKEN
{
"X-APPOTAPAY-AUTH": Bearer JWT_TOKEN,
"Content-Type": "application/json"
}
Params
Params | Required | Type | Description |
---|---|---|---|
partnerRefId | √ | String | This is unique code corresponding to a request send |
telco | √ | String | Vendor name (see more Table of content list vendor) |
telcoServiceType | √ | String | Service type (see more Table of content List service code) |
phoneNumber | √ | String | Phone number charge topup (format: 09x, 08x,..) |
amount | √ | Integer | Charge money |
signature | √ | String | Signature of parameter passed to the API, the parameter is included into signature like this: amount + partnerRefId + phoneNumber + telco + telcoServiceType (see more at how to generate signature) |
Data result
Params | Type | Description |
---|---|---|
errorCode | Integer | Error code result |
message | String | Description error code detail |
transaction | Object | Transaction object |
transaction.amount | Integer | Amount transaction |
transaction.topupAmount | String | Amount topup |
transaction.phoneNumber | String | Phone number to charge topup |
transaction.appotapayTransId | String | Transaction id from AppotaPay |
transaction.time | String | Transaction time |
account | Object | Account information |
account.balance | Integer | SBalance account after topup |
signature | String | Signature of parameter passed to the API, the parameter is included into signature like this:(amount + appotapayTransId + errorCode + phoneNumber + time + topupAmount) |
Example
Request
{
"partnerRefId": "AB123",
"telco": "viettel",
"telcoServiceType": "prepaid",
"phoneNumber": "0986868686",
"amount": 100000,
"signature": "b10294bae53e89919b3efd62a763bf3..."
}
Response
{
"errorCode": 0,
"message": "Thành công",
"transaction": {
"amount": 100000,
"topupAmount": 100000,
"appotapayTransId": "AP12adf21121",
"phonenumber": "0986868686",
"time": "10-04-2020 10:10:10",
},
"account": {
"balance": "121000000"
}
}