Checkout API
Hợp đồng endpoint
Tạo phiên thanh toán checkout có thể hiển thị thẻ, ví điện tử, phương thức ngân hàng, QR và tiền mã hóa trên một trang thanh toán GLODIPAY.
Môi trường: Sandbox: https://payment-sandbox.gpayprocessing.com. URL cơ sở Production được lấy từ trang API Keys trong Merchant Dashboard.
Quy tắc chữ ký
- Xóa trường
signaturekhỏi payload trước khi ký. - Sắp xếp các khóa cấp cao nhất theo thứ tự tăng dần tự nhiên.
- Trim giá trị chuỗi đệ quy và ép kiểu số lá theo cách mà các ví dụ spec mong đợi.
- Serialize thành JSON và ký bằng
md5WithRSAEncryptionsử dụng khóa riêng merchant. - Mã hóa Base64 chữ ký nhị phân và gửi dưới dạng trường
signature.
Bảng điều khiển sử dụng proxy ký cục bộ cho luồng này bất cứ khi nào bạn cung cấp khóa riêng.
Tham số request
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
merchantId | String(1,50) | M | ID Merchant. |
orderRef | String(1,250) | M | Mã tham chiếu giao dịch duy nhất cho mỗi merchant. |
amount | Float | M | Số tiền hóa đơn. Tối thiểu 1, tối đa 2 chữ số thập phân. |
currency | String(3) | M | Mã tiền tệ ISO 4217. Spec checkout v2 hiện tại ghi nhận USD. |
paymentMethod | String | M | Phương thức thanh toán. Hỗ trợ ALL, APM, card, googlepay, applepay, paypal, ibanking_push, local_bank_transfer, wire_transfer, wallet, alipay, wechat, skrill, crypto. |
cancelUrl | String(1,300) | M | URL chuyển hướng HTTPS khi hủy. |
callbackUrl | String(1,300) | M | URL chuyển hướng HTTPS sau khi thành công. |
notificationUrl | String(1,300) | M | Endpoint webhook HTTPS. |
errorUrl | String(1,300) | M | URL chuyển hướng HTTPS khi lỗi. |
orderDescription | String(max:3000) | M | Mô tả ngắn hiển thị trên trang checkout. |
metadata | JSON | O | Cặp key-value được trả về trong IPN và phản hồi truy vấn. |
transactionDocuments | JSON | O | Tài liệu hỗ trợ giao dịch. |
paymentFilter | JSON | O | Mảng các loại phương thức thanh toán cần loại trừ. |
paymentSorter | JSON | O | Mảng có thứ tự để kiểm soát thứ tự hiển thị. |
feeBySeller | Number(0-100) | O | Phần trăm phí xử lý do merchant trả. |
billingFirstName | String(max:255) | O | Tên thanh toán. |
billingLastName | String(max:255) | O | Họ thanh toán. |
billingStreet1 | String(max:255) | O | Địa chỉ thanh toán dòng 1. |
billingStreet2 | String(max:255) | O | Địa chỉ thanh toán dòng 2. |
billingCity | String(max:255) | O | Thành phố thanh toán. |
billingEmail | String(max:255) | O | Email người mua. |
billingState | String(2,255) | O | Bang hoặc tỉnh thanh toán. |
billingCountry | String | O | Mã quốc gia ISO 3166-1 alpha-2. |
billingPostalCode | String(max:25) | O | Mã bưu chính hoặc ZIP. |
billingPhoneCountryCode | String(max:10) | O | Mã quốc gia điện thoại. |
billingPhoneNumber | String(max:20) | O | Số điện thoại. |
brandName | String(1,255) | O | Ghi đè tên thương hiệu trên trang checkout. |
colorMode | String(1,255) | O | Tối đa 3 màu phân tách bằng ---. |
logoSource | String(1,255) | O | Ghi đè logo trên trang checkout. |
customerIp | String | O | Địa chỉ IP của khách hàng. |
websiteUrl | String(max:300) | O | URL website merchant. |
connectionMode | String | O | DIRECT_POST hoặc API. Xem Chế độ kết nối bên dưới. |
expiresAt | String | O | Hết hạn phiên theo ISO 8601. Mặc định 24 giờ. |
signature | String(max:750) | M | Chữ ký RSA-MD5. |
Chế độ kết nối
| Giá trị | Mô tả |
|---|---|
DIRECT_POST | Trình duyệt được chuyển hướng đến trang checkout ngay lập tức. |
API | Trả về URL paymentLink trong phản hồi JSON. |
Phản hồi và luồng xử lý
API: trả về JSON với status, transactionId, paymentLink và message.
DIRECT_POST: chuyển hướng người mua trực tiếp đến trang checkout và không trả về JSON cho server của bạn.
Sau thanh toán, GLODIPAY chuyển hướng trình duyệt đến callbackUrl với ?payload=base64-json. notificationUrl của bạn cũng nhận webhook JSON khi giao dịch đạt trạng thái cuối cùng.
Bộ xử lý webhook của bạn nên xác nhận nhận nhanh chóng với:
{
"returnCode": "100",
"description": "Received"
}Nguồn
Trang này được trích xuất từ Checkout API.