第三方跳转下单接口

Request

Body Params application/json

serial_number

string

请求流水号

required

每个请求必须上送唯一的流水号。流水号生成规程参考下文说明。

merchant_number

string

商户号

required

由易思汇提供。

sub_merchant_number

string

二级商户号

required

由易思汇提供

server_type

enum<string>

服务类型

required

不同的接口传递服务类型值不一样。

Allowed value:

merchant_jump_place_order

version

string

版本号

required

默认2.0.0。

callback_process

integer

optional

是否需要特殊处理，具体请联系易思汇

data

object

required

Json字符串，不同接口的data内容不一样，详细参考每个接口文档说明。

sensitive_data

object

required

敏感数据，Json格式。接口需要返回敏感数据，会在接口中请求参数中特殊说明，没有值的时候传递空字符串。加密流程参考接口加解密步骤

apartment_name

string

公寓名

required

公寓名

<= 200 characters

city_name_en

string

城市英文名

optional

公寓所在城市英文名

<= 200 characters

city_name_ch

string

城市中文名

optional

公寓所在城市中文名

<= 200 characters

merchant_order_id

string

商户订单号

optional

商户自己的订单号，这个订单号必须保证唯一。

<= 50 characters

merchant_user_key

string

商户用户唯一标识key

optional

例如用户的手机号。

<= 200 characters

tuition

number

总费用（外币）

required

如果商户服务费的币种跟总费用的币种一致时： tuition=merchant_service_fee+order_tuition,不一致时：tuition=order_tuition。

first_name_en

string

学生的英文名

optional

学生的英文名。

<= 50 characters

last_name_en

string

学生的英文姓

optional

学生的英文姓。

<= 50 characters

name_ch

string

用户中文名

optional

如果没有可以不用传。

<= 20 characters

student_id_number

string

学生证件号码

optional

学生身份证号码或者护照等

student_mobile

string

手机号

optional

手机号

student_email

string

学生邮件

optional

学生邮件

<= 50 characters

student_address

string

付款人地址

optional

学生的国内地址

<= 300 characters

school_name

string

学校名

optional

学生所在学校

<= 200 characters

wechat_number

string

微信号

optional

微信号，没有则不填。

<= 100 characters

fee_type_list

array [object {2}]

付款用途列表

optional

具体查看常量说明fee_type缴费类型说明，fee_type_desc固定传空，具体查看下面fee_type_list格式说明。

status_change_notify_url

string

订单状态异步通知地址

optional

与notify_url 作用类似，目前订单关闭汇款确认中会通知这个URL

sign

string

签名

optional

如果不使用易思汇提供的验签方式，需要双方协商讨论验签方式。签名流程参考接口加解密步骤。

return_info

string

optional

比如调用时候传递这个值为1，返回时候会也有一个这个字段返回1。

extend_info

string

扩展信息

optional

默认为空。

aeskey

string

aes的Key

optional

用于aes加密，key和iv是同一个值，需加密。加密流程参考接口加解密步骤。如果没有不需要加密则值为空

Example

{
    "serial_number": "string",
    "merchant_number": "string",
    "sub_merchant_number": "string",
    "server_type": "merchant_jump_place_order",
    "version": "string",
    "callback_process": 0,
    "data": {},
    "sensitive_data": {
        "apartment_name": "string",
        "city_name_en": "string",
        "city_name_ch": "string",
        "merchant_order_id": "string",
        "merchant_user_key": "string",
        "tuition": 0,
        "first_name_en": "string",
        "last_name_en": "string",
        "name_ch": "string",
        "student_id_number": "string",
        "student_mobile": "string",
        "student_email": "string",
        "student_address": "string",
        "school_name": "string",
        "wechat_number": "string",
        "fee_type_list": [
            {
                "fee_type": "string",
                "fee_type_desc": "string"
            }
        ],
        "status_change_notify_url": "string"
    },
    "sign": "string",
    "return_info": "string",
    "extend_info": "string",
    "aeskey": "string"
}

Request samples

Python

Shell

JavaScript

Java

Swift

Go

PHP

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.easytransfer.cn/server' \
--header 'Content-Type: application/json' \
--data-raw '{
    "serial_number": "string",
    "merchant_number": "string",
    "sub_merchant_number": "string",
    "server_type": "merchant_jump_place_order",
    "version": "string",
    "callback_process": 0,
    "data": {},
    "sensitive_data": {
        "apartment_name": "string",
        "city_name_en": "string",
        "city_name_ch": "string",
        "merchant_order_id": "string",
        "merchant_user_key": "string",
        "tuition": 0,
        "first_name_en": "string",
        "last_name_en": "string",
        "name_ch": "string",
        "student_id_number": "string",
        "student_mobile": "string",
        "student_email": "string",
        "student_address": "string",
        "school_name": "string",
        "wechat_number": "string",
        "fee_type_list": [
            {
                "fee_type": "string",
                "fee_type_desc": "string"
            }
        ],
        "status_change_notify_url": "string"
    },
    "sign": "string",
    "return_info": "string",
    "extend_info": "string",
    "aeskey": "string"
}'

Responses

🟢200成功

application/json

Body

status_code

string

状态码

required

000000：表示返回成功具体参考状态码说明。

>= 6 characters<= 6 characters

Example:

000000

message

string

描述说明

required

例如：请求成功。

>= 0 characters<= 100 characters

count

integer

数量

optional

下文data为一个列表，表示data列表里的长度。

data

array [object {1}]

具体数据

required

Json格式, 列表。不同接口返回的data内容不一样，详细参考每个接口说明。

jump_config_list

array [object {4}]

支付的配置

required

跳到h5页面或者跳到小程序进行支付

sensitive_data

array [object]

敏感数据加密后的数据解密请参考易思汇加解密文档

required

Json格式, 列表。接口需要返回敏感数据，会在接口中返回参数中特殊说明，如果没有敏感数据字段为空，不需要处理

return_info

string

预留返回信息

required

如果请求的时候传递这个参数的话，返回时候会原值返回。

extend_info

string

扩展信息，预留使用

required

sign

string

签名

required

如果不使用易思汇提供的验签方式，需要双方协商讨论验签方式。

aeskey

string

aes加密的key

required

用于aes加密，key和iv是同一个值，需加密。加密流程参考接口加解密步骤。如果没有不需要加密则值为空

Example

{
    "status_code": "000000",
    "message": "string",
    "count": 0,
    "data": [
        {
            "jump_config_list": [
                {
                    "jump_url": "string",
                    "jump_type": 0,
                    "appid": "string",
                    "original_id": "string"
                }
            ]
        }
    ],
    "sensitive_data": [
        {}
    ],
    "return_info": "string",
    "extend_info": "string",
    "sign": "string",
    "aeskey": "string"
}