卡支付

卡支付调用流程

客户可以使用借记卡或信用卡支付订单。授权方式根据支付渠道不同而有所不同，例如直接在 Coda 支付页面输入卡信息并进行 3DS 身份验证，或被重定向到渠道提供商的页面。

请求参数

参数	类型	长度	描述
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 的国家代码 国家和货币代码
lang	String	2	必填 各个国家的'Lang'选项列表
type	Number	1	1：数字内容物品 2：非数字内容物品
pay_type	Number	1	必填 卡支付使用 pay_type = 6。 更多详情请参阅 后端API
pay_channel	Number	3	每个支付渠道的代码。
merchant_name	String	128	可选 如果您希望指定商家名称，请在此字段中输入名称。 默认值为空。
items	ItemInfo	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 字段

Profile 字段

参数	类型	长度	描述
user_id	String	128	必填 客户的用户 ID
client_ip	String	15	可选 客户的 IP 地址 (仅支持IPv4)
name	String	128	可选 客户姓名
user_agent	String	512	可选 客户的用户代理数据（浏览器和操作系统的详细信息）

请求示例

v2.0 请求

{
  "project_id": "1", //此字段仅适用于 2.0 API
  "country": "360",
  "api_key": "test_e944d44f065eade8157737385a09",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "merchant_name": "Koko eBooks",
  "type": "1",
  "pay_type": "6",
  "email": "[e-mail]",
  "msisdn": "<Your number>",
  "items": [
    {
      "code": "1",
      "name": "Test Item",
      "price": 1000.0
    }
  ],
  "profile": {
    "user_id": "12345",
    "name": "Test"
  }
}

v1.0 请求

{
  "api_key": "<Your APIKey>",
  "order_id": "<Your Order ID>",
  "lang": "en",
  "merchant_name": "Koko eBooks",
  "type": "1",
  "pay_type": "6",
  "pay_channel": "-14",
  "email": "[e-mail]",
  "items": [
    {
      "code": "9",
      "name": "Killing",
      "price": 150
    }
  ],
  "profile": {
    "user_id": "Testuser397"
  }
}

响应参数

参数	类型	长度	描述
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	Object	N/A	请参考 Profile 字段

Profile 字段

参数	类型	长度	描述
redirect_url	String	128	仅当所选支付渠道遵循重定向 URL 流程时，才返回支付网关的重定向 URL。
merchantType	String	128	请忽略此字段。
user_id	String	128	客户的用户 ID
payment_code	Number	N/A	由支付渠道生成的代码。

响应示例

示例

{
    "txn_id": <Coda Transaction ID>,
    "txn_timeout": 26,
    "result_code": 0,
    "total_price": 150.0,
    "pay_instructions": "",
    "profile": {
        "user_id": "Testuser397",
        "merchantType": "Codapay",
        "redirect_url": "sample_URL.com",
        "payment_code": ""
    }
}

USD 订单交易参考

请查看此指南，了解更多关于 USD 交易的信息。