运营商支付(DCB)

运营商支付调用流程

运营商支付 MT-MO 验证流程

在运营商计费 MT-MO 验证流程中，客户通过短信接收支付指引，并根据支付指引发送短信以授权交易。

运营商支付 MO 验证流程

在运营商计费 MO 验证流程中，授权同样通过发送短信完成，但相关指引需要在商家的支付页面上提供。

请求参数

参数

类型

长度

描述

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 = 1。

对于运营商计费，如果客户输入的 MSISDN 与请求消息中的运营商计费不符，交易将因错误 240 而失败。更多详情请参阅后端API

mno_code

Number

N/A

必填

移动网络代码（MNC）。如果为空，Coda 将选择可用的移动网络运营商（MNO）

msisdn

Number

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

仅在需要 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

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

请求示例

{
  "project_id": "1", //此字段仅适用于 v2.0 API
  "country": "702",
  "api_key": "test_e944d44f065eade8157737385a09",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "merchant_name": "Codapay",
  "type": "1",
  "pay_type": "1",
  "mno_code": "52503",
  "msisdn": "<Your number>",
  "items": [
    {
      "code": "5",
      "name": "Test Item",
      "price": 60.0
    }
  ],
  "profile": {
    "user_id": "12345"

  }
}

{
  "project_id": "1", //此字段仅适用于 v2.0 API
  "country": "702",
  "api_key": "test_e944d44f065eade8157737385a09",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "merchant_name": "Codapay",
  "type": "1",
  "pay_type": "1",
  "mno_code": "52503",
  "items": [
    {
      "code": "5",
      "name": "Test Item",
      "price": 60.0
    }
  ],
  "profile": {
    "user_id": "12345"

  }
}

{
  "api_key": "<API Key>",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "pay_type": 1,
  "msisdn": "<Your number>",
  "mno_code": 22,
  "merchant_name": "Koko eBooks",
  "type": 1,
  "items": [
    {
      "code": "1",
      "name": "One Day",
      "price": 10000,
      "type": 1
    }
  ],
  "profile": {
    "user_id": "Testuser397"
  }
}

{
  "api_key": "<API Key>",
  "order_id": "<Your OrderID>",
  "lang": "en",
  "pay_type": 1,
  "mno_code": 22,
  "merchant_name": "Koko eBooks",
  "type": 1,
  "items": [
    {
      "code": "1",
      "name": "One Day",
      "price": 10000,
      "type": 1
    }
  ],
  "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

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

profile

Number

N/A

请参考 Profile 字段

Profile 字段

参数

类型

长度

描述

extInfoByte

N/A

请忽略此字段。

redirect_url

String

128

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

merchantType

String

128

请忽略此字段。

响应示例

{
    "txn_id": 6648561839693172536,
    "txn_timeout": 11,
    "result_code": 0,
    "total_price": 100.0,
    "pay_instructions": "We just sent an SMS to xxxxxx. To complete the transaction, send \"PAY\" followed by five digits code from the SMS to 75457. Example: PAY 12345.",
    "profile": {
        "extInfoByte": "0",
        "user_id": "Testuser397",
        "merchantType": "Codapay"
    }
}

{
    "txn_id": 6742026121325386583,
    "txn_timeout": 61,
    "result_code": 0,
    "total_price": 1000.0,
    "pay_instructions": "",
    "profile": {
        "extInfoByte": "0",
        "user_id": "12345",
        "merchantType": "Codapay",
        "redirect_url": "https://sample_URL.com"
    }
}

移动运营商代码

国家

支付渠道（MNO）

认证类型

网络代码

Bangladesh

Robi

N/A

47002

Indonesia

Indosat

MT-MO

51001 or 51021

Indonesia

Telkomsel

MT-MO

51010 or 51020

Indonesia

TRI

MT-MO

51089

Indonesia

51008 or 51011

Cambodia

Smart Axiata

MT-MO

45605

Laos

Unitel

MT-MO

45703

Myanmar

ATOM

MT-MO

41406

Myanmar

Ooredoo

MT-MO

41405

Malaysia

Celcom

MT-MO

50213, 50219

Malaysia

Maxis

50212 or 50217

Philippines

Smart/Sun

MT-MO

51503

Pakistan

Telenor Pakistan

MT-MO

52586

Singapore

MT-MO

52503

Taiwan

Asia Pacific Telecom

N/A

46605

Taiwan

Chunghwa Telecom

N/A

46692, 46611

Taiwan

FarEasTone

N/A

46602, 46607, 46601, 46606, 46603

上一页后台API调用流程概览

下一页电子钱包

最后更新于 7个月前

这有帮助吗？