卡 iFrame API
Ask AI
端点合约
创建卡 iframe 会话。GLODIPAY 返回托管卡表单的签名 URL，商户将该 URL 嵌入到 <iframe> 中。
POST /v2/card/iframeapplication/json需要签名
请求参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
merchantId | String(1,50) | M | 商户 ID。 |
orderRef | String(1,250) | M | 唯一交易引用。 |
amount | Float | M | 发票金额。 |
currency | String(3) | M | ISO 4217 货币代码。 |
cancelUrl | String(1,300) | M | 取消时的 HTTPS 重定向 URL。 |
callbackUrl | String(1,300) | M | 付款成功后的 HTTPS 重定向 URL。 |
notificationUrl | String(1,300) | M | HTTPS Webhook 端点。 |
errorUrl | String(1,300) | M | 付款出错时的 HTTPS 重定向 URL。 |
orderDescription | String(max:3000) | M | 简短订单描述。 |
metadata | JSON | O | 附加的键值对数据。 |
transactionDocuments | JSON | O | 支持文件。 |
paymentMethod | String | M | 必须为 card。 |
feeBySeller | Number(0-100) | O | 卖家费用百分比。 |
billingEmail | String(max:255) | O | 买家电子邮件。 |
billingCountry | String | O | ISO 3166-1 alpha-2 国家代码。 |
billingFirstName | String(max:255) | O | 账单名字。 |
billingLastName | String(max:255) | O | 账单姓氏。 |
billingStreet1 | String(max:255) | O | 账单地址行 1。 |
billingStreet2 | String(max:255) | O | 账单地址行 2。 |
billingCity | String(max:255) | O | 账单城市。 |
billingState | String(2,255) | O | 账单州。 |
billingPostalCode | String(max:25) | O | 邮政编码。 |
billingPhoneCountryCode | String(max:10) | O | 电话国家代码。 |
billingPhoneNumber | String(max:20) | O | 电话号码。 |
customerIp | String | O | 客户 IP 地址。 |
websiteUrl | String(max:300) | O | 商户网站 URL。 |
brandName | String(1,255) | O | 覆盖卡表单上的品牌名称。 |
colorMode | String(1,255) | O | 最多 3 种颜色，用 --- 分隔。 |
logoSource | String(1,255) | O | 覆 盖卡表单上的徽标。 |
expiresAt | String | O | ISO 8601 会话过期时间。 |
signature | String(max:750) | M | RSA-MD5 签名。 |
响应与嵌入流程
成功时，响应包含 status, transactionId, url, 和 message。将返回的 URL 嵌入到您的页面中：
<iframe
src="{url}"
width="100%"
height="600"
frameborder="0"
scrolling="no"
allowtransparency="true">
</iframe>签名的 URL 是临时的，并与结账会话绑定。GLODIPAY 通过 notificationUrl 发送最终结果，然后将买家重定向到 callbackUrl 或 errorUrl。
来源
此页面派生自 iFrame 卡支付 API。