H5支付 - EasyPay API

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

request_id

string

必需

商户订单 ID（唯一，用于请求幂等）

account_id

string

账户 ID

必需

payment_type

enum<string>

支付方式

必需

枚举值:

WECHAT_PAY

payment_flow

enum<string>

支付类型

必需

枚举值:

SCANAPPMINI_PROGRAMOFFICIAL_ACCOUNTH5

示例值:

H5

order_description

string

必需

订单描述（不超 127）

notify_url

string | null

可选

支付通知地址（只支持 https）

payment

object (PaymentDetail)

支付信息

必需

amount

integer <int64>

必需

标价金额（单位为分）

currency

string

标价币种

必需

expiry_time

string <date-time> | null

可选

订单超时时间（格式为：2023-01-01T10:00:00+08:00）

settlement

object (SettlementDetailRequest)

结算配置

必需

currency

string

结算币种

必需

metadata

object | null

附加参数

可选

额外字段

object

附加参数

可选

示例

{
  "request_id": "string",
  "account_id": "string",
  "payment_type": "WECHAT_PAY",
  "payment_flow": "SCAN",
  "order_description": "string",
  "notify_url": "string",
  "payment": {
    "amount": 0,
    "currency": "string",
    "expiry_time": "2019-08-24T14:15:22Z"
  },
  "settlement": {
    "currency": "string"
  },
  "metadata": {
    "property1": {},
    "property2": {}
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://demo-api.easypayx.com/v3/acquiring/payments' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "string",
    "account_id": "string",
    "payment_type": "WECHAT_PAY",
    "payment_flow": "SCAN",
    "order_description": "string",
    "notify_url": "string",
    "payment": {
        "amount": 0,
        "currency": "string",
        "expiry_time": "2019-08-24T14:15:22Z"
    },
    "settlement": {
        "currency": "string"
    },
    "metadata": {
        "property1": {},
        "property2": {}
    }
}'

返回响应

🟢200OK

application/json

Body

id

string

支付 ID

必需

request_id

string

商户订单 ID

必需

account_id

string

账户 ID

必需

payment_type

enum<string>

支付方式

必需

枚举值:

WECHAT_PAY

payment_flow

enum<string>

支付类型

必需

枚举值:

SCANAPPMINI_PROGRAMOFFICIAL_ACCOUNTH5

order_description

string

订单描述

必需

notify_url

string | null

支付通知地址

可选

payment

object

必需

amount

integer <int64>

必需

标价金额（单位为分）

currency

string

标价币种

必需

expiry_time

string <date-time> | null

可选

订单超时时间（格式为：2023-01-01T10:00:00+08:00）

next_action

object

必需

mweb_url

string

支付跳转地址

必需

额外字段

object

支付返回参数

可选

settlement

object

必需

currency

string

结算币种

必需

exchange_rate

string | null

汇率

可选

metadata

object | null

附加参数

可选

status

enum<string>

支付状态

必需

枚举值:

INITPENDINGSUCCESSFAILEDCANCELED

create_time

string <date-time>

创建时间

必需

complete_time

string <date-time> | null

支付完成时间

可选

示例

{
  "id": "string",
  "request_id": "string",
  "account_id": "string",
  "payment_type": "WECHAT_PAY",
  "payment_flow": "SCAN",
  "order_description": "string",
  "notify_url": "string",
  "payment": {
    "amount": 0,
    "currency": "string",
    "expiry_time": "2019-08-24T14:15:22Z"
  },
  "next_action": {
    "mweb_url": "string",
    "property1": {},
    "property2": {}
  },
  "settlement": {
    "currency": "string",
    "exchange_rate": "string"
  },
  "metadata": {},
  "status": "INIT",
  "create_time": "2019-08-24T14:15:22Z",
  "complete_time": "2019-08-24T14:15:22Z"
}

🟠400Bad Request

🟠404Not Found

🟠409Conflict

🔴500Internal Server Error

🔴503Service Unavailable