汇分账

创建外卡订单

开发中

POST

http://icp.dvchain.com.cn/interface/open/icp/createOrder

请求参数

Header 参数

charset

string

必需

示例值:

utf-8

merchantNumber

string

可选

示例值:

requestNo

string

可选

示例值:

20241001153807105450

requestTime

string

可选

示例值:

20241001153807

sign

string

可选

示例值:

VPR+aV7vnkKS/gpa7VzQo8IENpQ551aREsz260yA0RDnIDfBocvig0pbAA+mQ/oXGztuPQFs+qE8ntXi6NDtgNRMJBHWwAV3IBqZ76KJVi/AHN6mH9kJwqmfmYAM4DRqWMZOfTmS31pkdzToHkyez9Q8sGpUe6eVhPfbR4iWJ4k=

version

string

可选

示例值:

1.0.0

Body 参数application/json

requestBody

object

必需

amount

string

交易金额

必需

精确到两位小数0.01

<= 10 字符

billAddress

string

账单地址

必需

<= 500 字符

billCity

string

账单城市

必需

<= 100 字符

billCountry

string

账单城市

必需

<= 100 字符

billState

string

账单州/省

必需

<= 100 字符

billZip

string

账单邮编

必需

<= 100 字符

cardCsc

string

Cvv2

必需

<= 4 字符

cardExpMonth

string

有效期（月）

必需

<= 2 字符

cardExpYear

string

有效期（年）

必需

<= 4 字符

cardIssuingBank

string

信用卡发卡行

必需

<= 255 字符

cardNum

string

卡号

必需

<= 20 字符

currency

string

交易币种

必需

ISO标准

<= 3 字符

ext1

string

扩展字段1

可选

<= 100 字符

ext2

string

扩展字段2

可选

<= 100 字符

firstName

string

付款人名

必需

<= 100 字符

lastName

string

付款人姓

必需

<= 50 字符

orderNum

string

商户订单号

必需

<= 50 字符

productDesc

string

商品描述

必需

<= 200 字符

productName

string

商品名称

必需

<= 100 字符

productNum

string

商品数量

必需

<= 50 字符

remark

string

备注

必需

<= 1000 字符

returnUrl

string

返回地址

必需

<= 500 字符

shipAddress

string

收货地址

必需

<= 500 字符

shipCity

string

收货城市

必需

<= 100 字符

shipCountry

string

收货国家

必需

<= 100 字符

shipFirstname

string

收货人名

必需

<= 100 字符

shipLastname

string

收货人姓

必需

<= 50 字符

shipState

string

收货州/省

必需

<= 100 字符

shipZip

string

收货邮编

必需

<= 100 字符

transUrl

string

交易网站

必需

<= 500 字符

transactionType

string

支付类型

必需

直连:SALE 收银台: VIEWSALE

<= 20 字符

userEmail

string

付款人邮箱

必需

<= 200 字符

userIpAddress

string

付款人IP

必需

<= 50 字符

userPhone

string

付款人电话

必需

<= 50 字符

requestHead

object

必需

charset

string

必需

merchantNumber

integer

必需

requestNo

string

必需

requestTime

string

必需

sign

string

必需

version

string

必需

示例

{
  "requestBody": {
    "amount": "11.11",
    "billAddress": "海珠区",
    "billCity": "广州市",
    "billCountry": "AE",
    "billState": "广东省",
    "billZip": "441234",
    "cardCsc": "123",
    "cardExpMonth": "12",
    "cardExpYear": "2024",
    "cardIssuingBank": "工商银行",
    "cardNum": "6187183123527307",
    "currency": "CNY",
    "ext1": "00",
    "ext2": "123",
    "firstName": "张",
    "lastName": "三",
    "orderNum": "20241001152222677179",
    "productDesc": "apple",
    "productName": "苹果",
    "productNum": "9",
    "remark": "1234",
    "returnUrl": "https://www.baidu.com",
    "shipAddress": "硅谷1234号",
    "shipCity": "旧金山",
    "shipCountry": "AE",
    "shipFirstname": "李",
    "shipLastname": "四",
    "shipState": "加利福利亚",
    "shipZip": "123456",
    "transUrl": "https://epaylinks.cn",
    "transactionType": "SALE",
    "userEmail": "3534108287@qq.com",
    "userIpAddress": "192.168.1.1",
    "userPhone": "18035142506"
  },
  "requestHead": {
    "charset": "utf-8",
    "merchantNumber": 5,
    "requestNo": "20241001152222762331",
    "requestTime": "20241001152222",
    "sign": "bK4V8hejnZ6McY7R9/U9ogdrpE4Xq89kwxxN0KE+FZT+UsvKnHve2/W0w73nIe02nQU6ZNFHTQHta3hdf2Ai3DqFH4xzspqtoDU3dx6daO3r+HAD7PhR6VzQr7TWO4jE92nJT0xaKHmGHR9W4YnqhV+/tKRztavqdYTh/uAA7Vg=",
    "version": "1.0.0"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://icp.dvchain.com.cn/interface/open/icp/createOrder' \
--header 'charset: utf-8' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestBody": {
        "amount": "11.11",
        "billAddress": "海珠区",
        "billCity": "广州市",
        "billCountry": "AE",
        "billState": "广东省",
        "billZip": "441234",
        "cardCsc": "123",
        "cardExpMonth": "12",
        "cardExpYear": "2024",
        "cardIssuingBank": "工商银行",
        "cardNum": "6187183123527307",
        "currency": "CNY",
        "ext1": "00",
        "ext2": "123",
        "firstName": "张",
        "lastName": "三",
        "orderNum": "20241001152222677179",
        "productDesc": "apple",
        "productName": "苹果",
        "productNum": "9",
        "remark": "1234",
        "returnUrl": "https://www.baidu.com",
        "shipAddress": "硅谷1234号",
        "shipCity": "旧金山",
        "shipCountry": "AE",
        "shipFirstname": "李",
        "shipLastname": "四",
        "shipState": "加利福利亚",
        "shipZip": "123456",
        "transUrl": "https://epaylinks.cn",
        "transactionType": "SALE",
        "userEmail": "3534108287@qq.com",
        "userIpAddress": "192.168.1.1",
        "userPhone": "18035142506"
    },
    "requestHead": {
        "charset": "utf-8",
        "merchantNumber": 5,
        "requestNo": "20241001152222762331",
        "requestTime": "20241001152222",
        "sign": "bK4V8hejnZ6McY7R9/U9ogdrpE4Xq89kwxxN0KE+FZT+UsvKnHve2/W0w73nIe02nQU6ZNFHTQHta3hdf2Ai3DqFH4xzspqtoDU3dx6daO3r+HAD7PhR6VzQr7TWO4jE92nJT0xaKHmGHR9W4YnqhV+/tKRztavqdYTh/uAA7Vg=",
        "version": "1.0.0"
    }
}'

返回响应

🟢200成功

application/json

Body

responseHead

object

必需

charset

string

必需

version

string

必需

merchantNumber

string

必需

responseTime

string

必需

requestNo

string

必需

responseCode

integer

必需

responseMsg

string

必需

sign

string

必需

responseBody

object

必需

paccountNum

string

商户帐号

必需

<= 10 字符

pext1

string

扩展字段1

可选

<= 50 字符

pext2

string

扩展字段2

可选

<= 50 字符

pmid

string

商户编号

必需

<= 20 字符

ppayResult

string

状态

必需

-1:处理中 0: 失败 1: 成功

<= 3 字符

premark

string

备注

可选

<= 1000 字符

porderNum

string

商户订单号

必需

<= 50 字符

pcurrency

string

支付币种

必需

<= 3 字符

pamount

string

支付金额

必需

<= 10 字符

ptransNum

string

我司订单号

必需

<= 50 字符

ppayInfo

string

支付返回信息

必需

<= 1000 字符

示例

{
  "responseHead": {
    "charset": "utf-8",
    "version": "1.0.0",
    "merchantNumber": "5",
    "responseTime": "20241001160635",
    "requestNo": "20241001152222762331",
    "responseCode": 200,
    "responseMsg": "成功",
    "sign": "QQiTWLF/50KOcTSqueI534rFxZzHnXUYXRwNogPXMWVFU8JkrUOaqdZ+Sko4ivXOXZ3sgO7CcPYgcXuzXyDbxqUKvCx3J5z/5zFLhQtxEP4RlT/Qh2NLjr0eKcONFNLzxJjGkIMfo42Q90KHiFBGUMHNLvcEtmM8nqws/VWBXO0="
  },
  "responseBody": {
    "htmlCode": null,
    "paccountNum": "90006001",
    "pext1": "00",
    "pext2": "123",
    "pmid": "90006",
    "ppayResult": "1",
    "premark": "1234",
    "porderNum": "20241001152222677179",
    "pcurrency": "CNY",
    "pamount": "11.11",
    "ptransNum": "2024100116042466939409",
    "ppayInfo": "Approved"
  }
}

外卡退款查询

查询外卡订单