电子钱包

电子钱包调用流程

对于电子钱包支付类型，商家将收到一个重定向链接，供用户完成支付。通常这个链接要么是深度链接（直接打开钱包应用），要么是重定向页面，用户需要填写一些额外信息并授权支付。

请求参数

参数

类型

长度

描述

api_key

String

256

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

project_id

String

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

order_id

String

必填

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

country

Number

N/A

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

lang

String

必填

各个国家的'Lang'选项列表

type

Number

1：数字内容物品

2：非数字内容物品

pay_type

Number

必填

运营商支电子钱包使用 pay_type = 5。更多详情请参阅后端API

pay_channel

Number

每个支付渠道的代码。

pay_at

Number

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

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

msisdn

Number

可选 MSISDN（未格式化；不包含国家代码）

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

String

128

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

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

可选

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

user_agent

String

512

可选

客户的用户代理数据（浏览器和操作系统的详细信息）

name

String

256

可选

用户的全名。

id_no

Number

可选

巴西/墨西哥/阿根廷的身份证明文件称为 CPF。

document_type

String

N/A

可选

用户文件类型：

a. Cédula de ciudadanía（公民身份证）。 b. Tarjeta de identidad del menor de edad（未成年人身份证）。 c. Cédula de extranjería（外国人身份证）。

document_number

Number

N/A

可选

CC - Cédula de ciudadanía（公民身份证）。

TI - Tarjeta de identidad del menor de edad（未成年人身份证）。

CE - Cédula de extranjería（外国人身份证）。

v2.0 请求示例

{
  "project_id": "1", //此字段仅适用于 2.0 API
  "country": "458",
  "api_key": "test_e944d44f065eade8157737385a09",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "merchant_name": "Codapay",
  "type": "1",
  "pay_type": "5",
  "pay_channel": "-77",
  "email": "test@codapayments.com",
  "msisdn": "<Your Number>",
  "items": [
    {
      "code": "1",
      "name": "Test item",
      "price": 3.0
    }
  ],
  "profile": {
    "user_id": "12345"
  }
}

{
  "project_id": "1", //此字段仅适用于 2.0 API
  "country": "458",
  "api_key": "test_e944d44f065eade8157737385a09",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "merchant_name": "Codapay",
  "type": "1",
  "pay_type": "5",
  "pay_channel": "-77",
  "email": "test@codapayments.com",
  "msisdn": "<Your Number>",
  "items": [
    {
      "code": "1",
      "name": "Test item",
      "price": 3.0
    }
  ],
  "profile": {
        "name":"CodaUser",
        "user_id":"12345",
        "id_no":"88899988811"
  }
}

{
  "project_id": "1", //此字段仅适用于 2.0 API
  "country": "458",
  "api_key": "test_e944d44f065eade8157737385a09",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "merchant_name": "Codapay",
  "type": "1",
  "pay_type": "5",
  "pay_channel": "-77"
  "items": [
    {
      "code": "1",
      "name": "Test item",
      "price": 3.0
    }
  ],
  "profile": {
    "user_id": "12345"
  }
}

{
  "project_id": "1", //此字段仅适用于 2.0 API
  "country": "458",
  "api_key": "test_e944d44f065eade8157737385a09",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "merchant_name": "Codapay",
  "type": "1",
  "pay_type": "5",
  "pay_channel": "255",
  "email": "test@codapayments.com",
  "msisdn": "<Your Number>",
  "items": [
    {
      "code": "1",
      "name": "Test item",
      "price": 300.0,
      "type": "0",
    }
  ],
  "profile": {
    "document_number": "1134568011",
    "user_id": "12345",
    "document_type": "CC"
  }
}

v1.0 请求示例

{
    "api_key":"<YOUR API KEY>",
    "order_id":"<Your Order ID>",
    "lang":"en",
    "merchant_name":"Koko eBooks",
    "pay_type":"5",
    "pay_channel":"20",
    "type":"1",
    "msisdn":"<phone number>",
    "email":"<email address>" ,
    "items":[{
        "code":"456789",
        "name":"One Day",
        "price":1000.00
    }],
    "profile":{"user_id":"12345"}
}

{
    "api_key": "<YOUR API KEY>",
    "order_id": "<Your Order ID>",
    "lang": "en",
    "merchant_name": "Koko eBooks",
    "type": "1",
    "pay_type": "5",
    "pay_channel": "98",
    "email": "test@codapayments.com",
    "msisdn": "123432",
    "items": [
        {
            "code": "1",
            "name": "One Day",
            "price": 3
        }
    ],
    "profile":{"name":"CodaUser","user_id":"12345","id_no":"88899988811"}
}js

{
    "api_key":"<YOUR API KEY>",
    "order_id":"<Your Order ID>",
    "lang":"en",
    "merchant_name":"Koko eBooks",
    "pay_type":"5",
    "pay_channel":"39",
    "type":"1",
    "items":[{
        "code":"456789",
        "name":"One Day",
        "price":1000.00
    }],
    "profile":{"user_id":"12345"}
}

{
  "api_key": "<YOUR API KEY>",
  "order_id": "<Your Order ID>",
  "lang": "en",
  "pay_type": "5",
  "pay_channel": "255",
  "email": "test@codapayments.com",
  "type": "1",
  "merchant_name": "Koko eBooks",
  "items": [
    {
      "code": "1",
      "name": "Free Fire",
      "price": "1000.0",
      "type": "0",
    }
  ],
  "profile": {
    "document_number": "1134568011",
    "user_id": "12345",
    "document_type": "CC"
  }
}

响应参数

参数

类型

长度

描述

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

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

profile

Number

N/A

请参考 Profile 字段

Profile 字段

参数

类型

长度

描述

extInfoByte

Number

N/A

请忽略此字段。

redirect_url

String

128

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

例如：泰国 Rabbit Line Pay。

merchantType

String

128

这请忽略此字段。

qr_code_url

String

128

仅当所选支付渠道支持 QR 码流程时，才会返回支付网关的 QR 码 URL。

例如：马来西亚 Touch & Go 电子钱包。

响应示例

{
   "txn_id": <coda transaction ID>,
   "txn_timeout": 20,
   "result_code": 431,
   "result_desc": "Please wait a few minutes for your transaction to be completed. Need Help? Visit our <a href=“http://bit.ly/idCODAhelp” target=“_blank”>Help Center</a>.",
   "total_price": 1000.0,
   "pay_instructions": "",
   "profile": {
        "extInfoByte": "11",
        "user_id": "12345",
        "merchantType": "Codapay",
        "payment_code": ""
    }
}

{
    "txn_id": <coda transaction ID>,
    "txn_timeout": 1445,
    "result_code": 431,
    "result_desc": null,
    "total_price": 3.03,
    "pay_instructions": "",
    "profile": {
        "extInfoByte": "0",
        "id_no": "88899988811",
        "user_id":"12345",
        "redirect_url": "https://homolog.latamgateway.com/picpay/finish/8053d22c-2e78-4c2d-bd20-da32014440f1",
        "payment_code": ""
    }
}

{
    "txn_id": <coda transaction ID>,
    "txn_timeout": 11,
    "result_code": 0,
    "result_desc": null,
    "total_price": 1000.0,
    "pay_instructions": "",
    "profile": {
        "redirect_url": "https://linkaja/checkout/payment?message=LS0tLS1CRUdJTiBQR1AgTUVTU0FHRS0tLS0tClZlcnNpb246IEJDUEcgdjEu",
        "extInfoByte": "0",
        "payment_code": ""
    }
}

{
    "txn_id": <coda transaction ID>,
    "txn_timeout": 17,
    "result_code": 431,
    "total_price": 1000.0,
    "pay_instructions": "",
    "profile": {
        "extInfoByte": "0",
        "document_number": "1134568011",
        "user_id": "12345",
        "merchantType": "Codapay",
        "redirect_url": "https://cdn.safecharge.com/safecharge_resources/v1/validation-code-72309.html?notifyUrl=https%3A%2F%2Fapm.safecharge.com%2FApmConnector%2F8192341EAC1F4C9C3AAC718DA1F1AB22&locale=en_CO",
        "document_type": "CC",
        "payment_code": ""
    }
}

USD 订单交易参考

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

上一页运营商支付(DCB)

下一页便利店支付(OTC)

最后更新于 7个月前

这有帮助吗？