Card iFrame API
Ask AI
Hợp đồng Endpoint
Tạo phiên card iframe. GLODIPAY trả về một URL đã ký cho biểu mẫu thẻ được lưu trữ, và merchant nhúng URL đó vào một <iframe>.
POST /v2/card/iframeapplication/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. |
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 | 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. |
billingEmail | String(max:255) | O | Email người mua. |
billingCountry | String | O | Mã quốc gia ISO 3166-1 alpha-2. |
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. |
billingState | String(2,255) | O | Bang thanh toán. |
billingPostalCode | String(max:25) | O | Mã bưu chính / ZIP. |
billingPhoneCountryCode | String(max:10) | O | Mã quốc gia điện thoại. |
billingPhoneNumber | String(max:20) | O | Số điện thoại. |
customerIp | String | O | Địa chỉ IP khách hàng. |
websiteUrl | String(max:300) | O | URL website của Merchant. |
brandName | String(1,255) | O | Ghi đè tên thương hiệu trên biểu mẫu thẻ. |
colorMode | String(1,255) | O | Tối đa 3 màu được phân tách bằng ---. |
logoSource | String(1,255) | O | Ghi đè logo trên biểu mẫu thẻ. |
expiresAt | String | O | Hết hạn phiên ISO 8601. |
signature | String(max:750) | M | Chữ ký RSA-MD5. |
Luồng phản hồi và nhúng
Khi thành công, phản hồi chứa status, transactionId, url, và message. Nhúng URL trả về vào trang của bạn:
<iframe
src="{url}"
width="100%"
height="600"
frameborder="0"
scrolling="no"
allowtransparency="true">
</iframe>URL đã ký là tạm thời và gắn liền với phiên thanh toán. GLODIPAY gửi kết quả cuối cùng thông qua notificationUrl và sau đó chuyển hướng người mua đến callbackUrl hoặc errorUrl.
Nguồn
Trang này được trích xuất từ iFrame Card API.