USD 订单交易概览

商家请求价格可以选择使用美金，Coda系统协助兑换并显示当地货币给用户支付

后端API USD交易

请注意，USD 交易需要在货币代码上进行一些特定的配置。

请求参数

参数	类型	长度	描述
api_key	String	256	必填 Coda提供的API密钥 - 请参“入门指南”了解如何获取。
project_id	String	10	此字段仅适用于此字段仅适用于 v2.0 API，必填项 由 Coda 提供的 Project ID，对每个标题产品都是唯一的。 请参阅 Codapay 入门指南 了解
order_id	String	64	必填 您在支付请求发起时传递的订单ID
lang	String	2	必填 请参阅此处以查看可选项。
country	Number	N/A	必填 ISO 3166 的国家代码 国家和货币代码
type	Number	1	1：数字内容物品。 2：非数字内容物品。
pay_type	Number	1	必填 运营商支付使用 pay_type = 1。 对于运营商计费，如果客户输入的 MSISDN 与请求消息中的运营商计费不符，交易将因错误 240 而失败。 请参阅此处查看更多信息。
mno_code	Number	N/A	必填 移动网络代码。 如果为空，Coda 将选择可用的 MNO。
msisdn	Number	15	可选 MSISDN（未格式化；不包含国家代码）。 仅在需要 MSISDN 而非电子邮件时包含此项。
items	ItemInfo	N/A	必填 用户购买的商品列表
items[].code	String	128	必填 商家管理的商品代码。
items[].name	String	128	必填 所购买的商品名称。仅支持拉丁字符。
items[].price	Number	N/A	必填 商品价格包含以请求中指定的货币计算的任何税费。
profile	Map	N/A	请参考此处

Profile字段

USD 交易需要在Profile参数中设置 "currency_code = 840"。

参数	类型	长度	描述
user_id	String	N/A	必填 客戶的用戶ID
currency_code	Number	3	必填 设置 USD 为 "currency_code = 840"。

响应参数

参数	类型	长度	描述
result_code	Number	N/A	ResultCode将帮助指示交易的状态。 ResultCode = 0 表示交易成功。 ResultCode = 431 或 216 表示交易待处理 所有其他ResultCode值表示交易失败。您可以在这里找到完整的错误代码及其解释。
txn_id	Number	N/A	从支付请求发起返回的Coda订单ID。
txn_timeout	Number	N/A	交易超时时间（分钟）。
total_price	Number	N/A	未格式化的数字值。 对于印度尼西亚、智利、韩国、台湾和越南的货币，不支持小数。
pay_instructions	String	15	如果响应返回了此值，商家应在页面上向客户显示提供的支付指引。
profile	Map	N/A	请参阅以下 其他详细信 (Other details)。

Profile field里的Other details

参数	类型	长度	描述
extInfoByte	Number	N/A	请忽略此字段。
foreign_currency_code	Number	3	货币用于用户实际支付的费用。
exchange_rate	Number	N/A	Coda 的 USD 汇率，汇率每天更新。
foreign_currency_amt	Number	N/A	在发起请求时提供的原始金额。
currency_code	Number	3	使用 USD 发起订单时，将返回 "currency_code":"840"。
local_currency_code	Number	3	各个地区的本地货币代码。 欲了解每种货币代码的详细信息，请参阅此处
local_currency_amt	Number	N/A	用户为交易支付的总金额。此金额将始终以当地货币表示。

示例

v2.0 请求

{
    "api_key": "test_e944d44f065eade8157737385a09",
    "order_id": "123456",
    "project_id": "1",//This field is only needed for v2.0 API
    "lang": "en",
    "merchant_name": "Codapay",
    "pay_type": "5",
    "pay_channel": -76,
    "pay_at": "4",
    "type": "1",
    "country": "702",
    "items": [
        {
            "code": "456789",
            "name": "Test Item",
            "price": 100
        }
    ],
    "profile": {
        "user_id": "12345"
    }
}

v1.0 请求

{
    "api_key": "e944d44f065eade8157737385a094a",
    "order_id": "123456",
    "lang": "en",
    "merchant_name": "Amazon",
    "pay_type": "5",
    "pay_channel": -76,
    "pay_at": "4",
    "type": "1",
    "items": [
        {
            "code": "456789",
            "name": "GameCredit",
            "price": 100
        }
    ],
    "profile": {
        "user_id": "12345",
        "currency_code": "840"
    }
}

请求成功响应

{
    "txn_id": 7395063022892074013,
    "txn_timeout": 19,
    "result_code": 0,
    "result_desc": null,
    "total_price": 135.33,
    "pay_instructions": "",
    "profile": {
        "extInfoByte": "0",
        "foreign_currency_code": "840",
        "exchange_rate": "1.3533",
        "foreign_currency_amt": "100.0",
        "local_currency_code": "702",
        "currency_code": "840",
        "local_currency_amt": "135.33",
        "user_id": "12345",
        "projectId": "1",
        "merchantType": "Codapay",
        "redirect_url": "https://partner-api.stg-myteksi.com/grabid/v1/oauth2/authorize?acr_values=consent_ctx%3AcountryCode%3DSG,currency%3DSGD&client_id=8488e516acc54f88bad99c435cc18fdd&redirect_uri=https%3A%2F%2Fmidas.codapayments.com%2Fepcgw%2Fgrab%2Fredirect&request=eyJhbGciOiAibm9uZSJ9.eyJjbGFpbXMiOnsidHJhbnNhY3Rpb24iOnsidHhJRCI6ImFkNzI5ZjA1NzQ0MzQyMTA4ODQ5ZDQyMzcyZTFlYWZiIn19fQ.&response_type=code&code_challenge=csKQlGqOEs5LVHsLEFRQemfNIu4inReam4wfysr8zZY&code_challenge_method=S256&scope=payment.one_time_charge&state=7395063022892074846&nonce=0r2bt4lD0oRHxh9B",
        "payment_code": ""
    }
}

请求失败响应

{
    "txn_id": 0,
    "txn_timeout": 0,
    "result_code": 103,
    "result_desc": "This transaction has been cancelled. No charges were made. (error:103)",
    "total_price": 0.0,
    "pay_instructions": null,
    "profile": null
}