Server-to-Server Card API
Ask AI
Hợp đồng Endpoint
Gửi chi tiết thẻ trực tiếp đến GLODIPAY từ máy chủ của riêng bạn. Luồng này yêu cầu việc thu thập thẻ tuân thủ PCI ở phía merchant.
POST /v2/card/apiapplication/jsonYêu cầu chữ ký
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 | Tham chiếu giao dịch duy nhất. |
amount | Float | M | Số tiền hóa đơn. Tối thiểu 1. |
currency | String(3) | M | Mã tiền tệ ISO 4217. |
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 thanh toán 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 thanh toán. |
orderDescription | String(max:3000) | M | Mô tả đơn hàng ngắn gọn. |
metadata | JSON | O | Dữ liệu key-value đính kèm. |
transactionDocuments | JSON | O | Các tài liệu hỗ trợ. |
paymentMethod | String | M | Phải là card. |
feeBySeller | Number(0-100) | O | Phần trăm phí người bán. |
billingFirstName | String(max:255) | M | Tên thanh toán. |
billingLastName | String(max:255) | M | Họ thanh toán. |
billingStreet1 | String(max:255) | M | Đị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) | M | Thành phố thanh toán. |
billingEmail | String(max:255) | M | Email người mua. |
billingState | String(min:2,max:255) | C | Bắt buộc khi billingCountry là US hoặc CA. |
billingCountry | String | M | Mã quốc gia ISO 3166-1 alpha-2. |
billingPostalCode | String(max:25) | M | Mã bưu chính / ZIP. |
billingPhoneCountryCode | String(max:10) | O | Mã quốc gia điện thoại. |
billingPhoneNumber | String(max:30) | M | Số điện thoại. |
cardNumber | String(12,19) | M | Số thẻ. |
cardMonth | String | M | Tháng hết hạn, ví dụ 12. |
cardYear | String | M | Năm hết hạn 2 chữ số, ví dụ 30. |
cardSecurityCode | String(3,4) | M | CVV / CVC. |
customerIp | String | M | Địa chỉ IP khách hàng. |
websiteUrl | String(max:300) | O | URL website của Merchant. |
expiresAt | String | O | Hết hạn phiên ISO 8601. |
browserDetails | JSON | M | Đối tượng vân tay trình duyệt. |
signature | String(max:750) | M | Chữ ký RSA-MD5. |
Các trường hợp phản hồi
Các giá trị trạng thái phản hồi:
success— Thanh toán hoàn tất ngay lập tức. Trả vềdata.transactionId.redirect— Yêu cầu 3DS. Chuyển hướng người mua đếndata.url. Sau 3DS, GLODIPAY gửi kết quả qua IPN và chuyển hướng người mua đếncallbackUrl.pending— Đang chờ xác nhận từ PSP. Kết quả cuối cùng sẽ được gửi qua IPN.error— Thanh toán thất bại. HTTP 422 cho các lỗi xác thực (với mảngerrors), HTTP 400/500 cho các lỗi xử lý.
Nguồn
Trang này được trích xuất từ Server-to-Server Card API.