For the complete documentation index, see llms.txt. This page is also available as Markdown.

便利店支付(OTC)

便利店支付(OTC)调用流程

使用便利店支付方式,客户可以在便利店或其他指定的支付柜台完成支付。商家将在Profile字段中接收到一个唯一的支付代码,客户在支付时将此代码出示给柜台。

有关更多详情,请参阅响应表中的Profile字段中的便利店信息。

请求参数

参数
类型
长度
描述

api_key

String

256

必填 Coda提供的API密钥 - 请参考 Codapay 入门指南 了解如何获取。

project_id

String

10

此字段仅适用于 v2.0 API,必填项 由 Coda 提供的 Project ID,对每个标题产品都是唯一的。 请参阅 Codapay 入门指南 了解

order_id

String

64

必填

您在支付请求发起时传递的订单ID

country

Number

N/A

必填 ISO 3166 的国家代码 国家和货币代码

type

Number

1

1:数字内容物品

2:非数字内容物品

pay_type

Number

1

必填

便利店支付使用 pay_type = 3。 更多详情请参阅 后端API

pay_channel

Number

3

每个支付渠道的代码。

pay_at

Number

2

此字段指示客户应在哪里完成购买。

1 = 银行柜台 2 = 网络银行 3 = 在线账单支付 4 = 电子钱包 5 = 自动取款机 14 = 便利店

msisdn

Number

15

可选 MSISDN(未格式化;不包含国家代码)

仅在需要 MSISDN 而非电子邮件时包含此项。

merchant_name

String

128

可选 如果您希望指定商家名称,请在此字段中输入名称。

默认值为空。

items

Number

N/A

必填

用户购买的商品列表

items[].code

String

128

必填

商家的商品代码

items[].name

String

128

必填

商品名称,仅支持拉丁字符

items[].price

Number

N/A

必填 已含税的商品价格(已含税),以请求中指定的货币计价

items[].type

Number

N/A

必填 默认值=1

profile

Map

N/A

Profile 字段

参数
类型
长度
描述

user_id

String

128

必填

客户的用户 ID

client_ip

String

15

可选 客户的 IP 地址 (仅支持IPv4)

name

String

128

可选 客户姓名

请求示例

响应参数

参数
类型
长度
描述

result_code

Number

N/A

ResultCode将帮助指示交易的状态。

ResultCode = 0 表示交易成功。 错误代码列表请参阅 常见错误代码

result_desc

String

512

如果resultCode返回错误,则该值描述错误信息。

txn_id

Number

N/A

支付请求发起返回的Coda订单ID。

txn_timeout

Number

N/A

交易超时时间(分钟)

total_price

Number

N/A

用户支付的总金额,以本地货币计价。

pay_instructions

String

15

如果响应返回了此值,商家应在页面上向客户显示提供的支付指引。

profile

Number

N/A

请参考 Profile 字段

Profile 字段

参数
类型
长度
描述

extInfoByte

Number

N/A

请忽略此字段。

payment_code

Number

N/A

由支付渠道生成的代码。

user_id

Number

N/A

客户的用户 ID

id_no

String

N/A

客户的身份证号。

name

String

N/A

客户姓名

redirect_url

String

128

仅当所选支付渠道遵循重定向 URL 流程时,才返回支付网关的重定向 URL。

响应示例

最后更新于

这有帮助吗?