发起支付 - 点点易付

请求参数

Header 参数

Content-Type

string

必需

表明 RFC2616 中定义的请求报文的媒体类型

示例值:

application/json; charset=UTF-8

signature

string

包含请求的签名值

必需

示例值:

*********

timestamp

string

必需

Unix 时间戳（毫秒）

示例值:

1743487706607

timezone

string

必需

时区(根据跟随设定的时间戳)

示例值:

Asia/Shanghai

Body 参数application/json

merchant_id

string

商户唯一标识符

必需

env

object

必需

terminal_type

string

必需

商户服务适用的终端类型。有效值为：

WEB: 客户端终端类型为网站，通过 PC 浏览器打开。
WAP: 客户端终端类型为 H5 页面，通过移动浏览器打开。
APP: 客户端终端类型为移动应用。
MINI_APP: 商户端的终端类型为手机小程序。

client_ip

string

客户IP地址

必需

<= 64 字符

browser_info

object

必需

下单的浏览器环境信息

device_info

object

可选

order

object

必需

merchant_order_id

string

必需

在商户端识别订单的专属 ID，由直接向客户提供服务或商品的商户分配。此字段用于用户消费记录显示以及如争议追踪或处理客户投诉等其他进一步操作。

<= 64 字符

goods

array [object {8}]

可选

商品信息，包括订单中商品的 ID、名称、价格和数量。

shipping

object

必需

配送信息，包括收件人（姓名、电话号码、电子邮件和配送地址）的信息，以及配送服务提供商的信息。

payment_amount

object

收单比重

必需

payment_method

object

必需

商户或收单机构用于收款的支付方式。

metadata

object

可选

自定义源数据以key/value表示

redirect_url

string

必需

用户完成支付后被重定向到的商户页面链接。

<= 2048 字符

示例

{
  "merchant_id": "1",
  "env": {
    "terminal_type": "WEB",
    "client_ip": "143.45.4.222",
    "browser_info": {
      "user_agent": "Mozilla/5.0 (compatible; MSIE 7.0; Windows NT 5.1; Trident/5.1)"
    }
  },
  "order": {
    "merchant_order_id": "99999999999",
    "shipping": {
      "shipping_name": {
        "first_name": "KING",
        "last_name": "MIsa",
        "full_name": "KING MIsa"
      },
      "shipping_address": {
        "country": "US",
        "state": "TX",
        "city": "Austin",
        "address1": "789 Oak Ave",
        "address2": "",
        "zip_code": "78701"
      },
      "email": "example@example.com",
      "phone": "+864-281-1794",
      "carrier": "USPS"
    },
    "payment_amount": {
      "currency": "USD",
      "value": 1000
    },
    "payment_method": {
      "payment_type": "CARD",
      "payment_data": {
        "country": "US",
        "card_number": "4111111111111111",
        "expiry_year": "30",
        "expiry_month": "03",
        "cvv": "737",
        "card_holder_name": {
          "first_name": "KING",
          "last_name": "MIsa",
          "full_name": "KING MIsa"
        },
        "billing_address": {
          "country": "US",
          "state": "TX",
          "city": "Austin",
          "address1": "789 Oak Ave",
          "address2": "",
          "zip_code": "78701"
        },
        "requires_3ds": false
      }
    },
    "metadata": {
      "shop": "happy",
      "domain": "example.com"
    }
  },
  "redirect_url": "https://example.com/reutrn"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.diandianpay.com/api/v1/payment' \
--header 'signature: *********' \
--header 'timestamp: 1743487706607' \
--header 'timezone: Asia/Shanghai' \
--header 'Content-Type: application/json; charset=UTF-8' \
--data-raw '{
    "merchant_id": "1",
    "env": {
        "terminal_type": "WEB",
        "client_ip": "143.45.4.222",
        "browser_info": {
            "user_agent": "Mozilla/5.0 (compatible; MSIE 7.0; Windows NT 5.1; Trident/5.1)"
        }
    },
    "order": {
        "merchant_order_id": "99999999999",
        "shipping": {
            "shipping_name": {
                "first_name": "KING",
                "last_name": "MIsa",
                "full_name": "KING MIsa"
            },
            "shipping_address": {
                "country": "US",
                "state": "TX",
                "city": "Austin",
                "address1": "789 Oak Ave",
                "address2": "",
                "zip_code": "78701"
            },
            "email": "example@example.com",
            "phone": "+864-281-1794",
            "carrier": "USPS"
        },
        "payment_amount": {
            "currency": "USD",
            "value": 1000
        },
        "payment_method": {
            "payment_type": "CARD",
            "payment_data": {
                "country": "US",
                "card_number": "4111111111111111",
                "expiry_year": "30",
                "expiry_month": "03",
                "cvv": "737",
                "card_holder_name": {
                    "first_name": "KING",
                    "last_name": "MIsa",
                    "full_name": "KING MIsa"
                },
                "billing_address": {
                    "country": "US",
                    "state": "TX",
                    "city": "Austin",
                    "address1": "789 Oak Ave",
                    "address2": "",
                    "zip_code": "78701"
                },
                "requires_3ds": false
            }
        },
        "metadata": {
            "shop": "happy",
            "domain": "example.com"
        }
    },
    "redirect_url": "https://example.com/reutrn"
}'

返回响应

🟢200成功

application/json

Body

data

object

必需

amount

integer

必需

以最小币种单位的正整数形式表示的金额值。例如，如果币种是USD金额是$1.00，则将此参数的值设置为100

currency

string

必需

币种代码，值为遵循 ISO 4217 标准的三位币种代码。

string

点点系统唯一标识符

必需

merchant_order_id

string

必需

result

object

必需

next_action

object

需要客户进一步操作

可选

示例

{
  "data": {
    "amount": 7506,
    "currency": "USD",
    "id": "pi_dyanFivWOgqbD43bZihyyl5F",
    "merchant_order_id": "2d187596-2aa1-43a5-b4b3-4a339cd61491",
    "result": {
      "result_code": "SUCCEEDED",
      "result_status": "S"
    }
  }
}