创建订单

POST

/api/pay/studypay/case/create

合作方提交学生基本信息、付款人基本信息、打款信息等，将用于备案及创建Ebon订单。
学生首次申请付款，需传输全量信息进行客户及付款人创建。再次创建时，您可选择传输Customer ID及Payer ID交互。注意在同一次请求中，您只能选择 ID或Detail交互。
文件请使用上传文件接口获得文件ID后再回传。

请求参数

Header 参数

Body 参数application/json

示例

{"customerDetail":
{"addressMetaData":{"country":"中国","state":"浙江省","city":"杭州市","district":"余杭区","streetName":"仓前街道","streetNumber":"31",
  "unitNumber":"33","postcode":"310021"},
  "customerChineseName":"小希测试","firstName":"xiao","lastName":"xi","dateOfBirth":"2008-05-13","occupation":"学生",
  "nationality":"CN","phone":"13477494289","email":"g.vzrdpuc@qq.com","idType":"00","idNumber":"330124200805130214",
  "certIssueDate":"2010-11-08","certExpireDate":"2025-06-27","certFront":"ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp",
  "certBack":"ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp",
  "studentId":"74123333333333"},"payerDetail":{"address":"宁夏回族自治区台东县分宜县",
  "addressMetaData":{"country":"中国","state":"浙江省","city":"杭州市","district":"余杭区","streetName":"仓前街道",
    "streetNumber":"2","unitNumber":"100","postcode":"24"},"payerName":"小希付款人大大大大","firstName":"ceshi","lastName":"xiaoxi",
  "payerRelation":1,"dateOfBirth":"1995-09-28","idType":"00","idNumber":"330125199509280125",
  "certFront":"ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp","certBack":"ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp",
  "certIssueDate":"2001-02-19",
  "certExpireDate":"2025-11-10","payerNationality":"CN"},"payoutDetails":[{"payItems":["1","2"],
  "payAmount":"8000.00","payCurrency":"AUD","payeeName":"university xiao xi","referenceList":[{"referenceType":"00",
    "referenceValue":"1222322"}],"attachment":["ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp","ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp"]},{"payItems":["1","2"],
  "payAmount":"6000.00","payCurrency":"AUD","payeeName":"university xiao xi","referenceList":[{"referenceType":"00",
    "referenceValue":"12312312"}],"attachment":["ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp",
    "ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp"]}],"requestId":"TEST202409100003"}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/pay/studypay/case/create' \
--header 'x-token: {{x-token}}' \
--header 'ebfs-key: apiKey' \
--header 'ebfs-timestamp: timestamp' \
--header 'ebfs-nonce;' \
--header 'ebfs-signature;' \
--header 'Content-Type: application/json' \
--data-raw '{"customerDetail":
{"addressMetaData":{"country":"中国","state":"浙江省","city":"杭州市","district":"余杭区","streetName":"仓前街道","streetNumber":"31",
  "unitNumber":"33","postcode":"310021"},
  "customerChineseName":"小希测试","firstName":"xiao","lastName":"xi","dateOfBirth":"2008-05-13","occupation":"学生",
  "nationality":"CN","phone":"13477494289","email":"g.vzrdpuc@qq.com","idType":"00","idNumber":"330124200805130214",
  "certIssueDate":"2010-11-08","certExpireDate":"2025-06-27","certFront":"ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp",
  "certBack":"ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp",
  "studentId":"74123333333333"},"payerDetail":{"address":"宁夏回族自治区台东县分宜县",
  "addressMetaData":{"country":"中国","state":"浙江省","city":"杭州市","district":"余杭区","streetName":"仓前街道",
    "streetNumber":"2","unitNumber":"100","postcode":"24"},"payerName":"小希付款人大大大大","firstName":"ceshi","lastName":"xiaoxi",
  "payerRelation":1,"dateOfBirth":"1995-09-28","idType":"00","idNumber":"330125199509280125",
  "certFront":"ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp","certBack":"ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp",
  "certIssueDate":"2001-02-19",
  "certExpireDate":"2025-11-10","payerNationality":"CN"},"payoutDetails":[{"payItems":["1","2"],
  "payAmount":"8000.00","payCurrency":"AUD","payeeName":"university xiao xi","referenceList":[{"referenceType":"00",
    "referenceValue":"1222322"}],"attachment":["ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp","ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp"]},{"payItems":["1","2"],
  "payAmount":"6000.00","payCurrency":"AUD","payeeName":"university xiao xi","referenceList":[{"referenceType":"00",
    "referenceValue":"12312312"}],"attachment":["ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp",
    "ebfs/studypay/8bd15004-3944-478e-a3ae-d47f036ef3bf.bmp"]}],"requestId":"TEST202409100003"}'

返回响应

🟢200OK

application/json

Body

示例

{
    "code": "string",
    "data": {
        "caseId": "string",
        "customerId": "string",
        "payerId": "string",
        "payoutMethod": [
            0
        ]
    },
    "errorArgs": [
        {}
    ],
    "message": "string"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

修改于 2024-10-22 01:15:36

Request Param参数说明

更新订单支付信息