获取付款地址接口

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:

get_special_pay_url

version

string

版本号

required

默认2.0.0。

callback_process

integer

optional

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

data

object

required

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

order_id

string

易思汇订单号

required

易思汇订单号

<= 30 characters

merchant_user_key

string

商户用户唯一标识key

required

商户用户唯一标识key,例如用户的手机号。

<= 200 characters

notify_url

string

异步通知地址

required

可以修改旧的异步通知地址，这边处理完后会异步通知（POST方法)这个地址支付处理的结果。

<= 500 characters

back_jump_url

string

跳转地址

required

可以修改旧的跳转地址，进入我们支付结果页面后点击返回商户，会回到这个地址。

<= 500 characters

back_page_url

string

跳转页面地址

optional

可以修改旧的跳转页面地址，在页面点击回退按钮，返回到商户页面

<= 500 characters

appid

string

商户的微信小程序的appid

optional

如果跳转地址是小程序地址，那这个参数需要传递

<= 100 characters

sensitive_data

object

required

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

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": "get_special_pay_url",
    "version": "string",
    "callback_process": 0,
    "data": {
        "order_id": "string",
        "merchant_user_key": "string",
        "notify_url": "string",
        "back_jump_url": "string",
        "back_page_url": "string",
        "appid": "string"
    },
    "sensitive_data": {},
    "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": "get_special_pay_url",
    "version": "string",
    "callback_process": 0,
    "data": {
        "order_id": "string",
        "merchant_user_key": "string",
        "notify_url": "string",
        "back_jump_url": "string",
        "back_page_url": "string",
        "appid": "string"
    },
    "sensitive_data": {},
    "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内容不一样，详细参考每个接口说明。

pay_config_list

array [object {3}]

required

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": [
        {
            "pay_config_list": [
                {
                    "pay_url": "string",
                    "pay_type": 0,
                    "appid": "string"
                }
            ]
        }
    ],
    "sensitive_data": [
        {}
    ],
    "return_info": "string",
    "extend_info": "string",
    "sign": "string",
    "aeskey": "string"
}