API gạch thẻ
Endpoint: /v1/services/card_charging?api_key=YOUR_API_KEY
Method: POST
Header: Cách tạo JWT_TOKEN
{ "X-APPOTAPAY-AUTH": Bearer JWT_TOKEN, "Content-Type": "application/json"}
#
Tham sốTham số | Yêu cầu | Kiểu dữ liệu | Mô tả |
---|---|---|---|
code | √ | String | Mã thẻ ở dạng mã hoá |
serial | √ | String | Seri thẻ |
vendor | √ | String | để mặc định là: appota |
partner_code | √ | String | Mã Partner code nhận được từ phía AppotaPay cung cấp |
service_name | √ | String | Mã dịch vụ mà phía đối tác đã đăng ký |
transaction_id | √ | String | Mã giao dịch phía đối tác sinh ra, duy nhất cho mỗi giao dịch (từ 5 - 50 kí tự) |
signature | √ | String | Thông tin hash các params gửi sang API (signature= SHA256(code + serial + vendor + partner_code + service_name + transaction_id + secret_key)) Secret key phía AppotaPay cung cấp |
#
Dữ liệu trả vềTham số | Kiểu dữ liệu | Mô tả |
---|---|---|
error_code | String | Mã lỗi |
message | String | Mô tả chi tiết mã lỗi |
data | Object | Mô tả chi tiết giao dịch khi thành công |
data.amount | Integer | Mệnh giá thẻ |
data.serial | String | Seri thẻ |
data.transaction_id | String | Mã giao dịch phía AppotaPay |
data.time | String | Thời gian giao dịch |
#
Ví dụ#
Response{ "error_code": "00", "message": "Transaction success", "data": { "amount": 100000, "serial": "OTA123456789", "transaction_id": "abc123", "time": "10:05:01 08/05/2019 GMT+7" }}