Tài liệu tích hợp

I. Tạo và thiết lập ứng dụng

Để có thể gọi API nạp thẻ trên Cổng Đổi Thẻ, bạn phải đăng ký Tài khoản và tạo Ứng dụng kết nối.
Trong đó có các thông tin quan trọng như sau:

• Mã hiệu ứng dụng (appCode): truyền lên mỗi lần gọi API
• Mã khóa bí mật (privateKey): để mã hóa chữ ký truyền lên mỗi lần gọi API
• URL Callback (callbackUrl): API phía ứng dụng của bạn, để Cổng Đổi Thẻ gọi lại báo kết quả đổi thẻ.
• Nếu không tích hợp Nạp thẻ, phần CallackUrl có thể nhập một URL tạm nào đó, ví dụ https://google.com.

II. Sơ đồ quy trình gọi API nạp thẻ

1. Từ ứng dụng của bạn, gọi hàm API nạp thẻ https://kingbox79.club/api/cardCharge.
   
   • Phương thức: POST
   • Định dạng: JSON (application/json)
   • Tham số truyền vào: { "appCode": "string", "transId": "string", "cardType": "string", "cardSeri": "string", "cardCode": "string", "initValue": 0, "signature": "string" }
   • Dữ liệu trả về: { "code": 0, "message": "string", "extraData": { "transId": "string", "cardType": "string", "cardSeri": "string", "cardCode": "string", "initValue": 0, "cardValue": 0, "addedValue": 0, "signature": "string" } }
   Để biết thêm chi tiết, xin tham khảo TẠI ĐÂY.
2. Nhận kế quả phản hồi, kiểm tra giá trị code.
   
   • Giá trị code = 0: Thành công! Kiểm tra thông tin mệnh giá khai báo và thực nạp trong extraData
   • Giá trị code = 1: Chờ xử lý! Sau khi xử lý, hệ thống sẽ gọi hàm CallBack trên ứng dụng của bạn để báo kết quả sau
   • Giá trị code > 1: Thất bại! Xem nội dung message để biết nguyên nhân thất bại.
3. Viết API cardCallback trên ứng dụng của bạn.
   
   • Phương thức: POST
   • Định dạng: JSON (application/json)
   • Tham số truyền vào: { "code": 0, "message": "string", "extraData": { "transId": "string", "cardType": "string", "cardSeri": "string", "cardCode": "string", "initValue": 0, "cardValue": 0, "addedValue": 0, "signature": "string" } }
     Tham số truyền vào API cardCallback cũng tương tự tham số trả về từ API cardCharge.