统一收单交易支付接口

开发环境

POST

/v3/alipay/trade/pay

alipay.trade

收银员使用扫码设备读取用户手机支付宝“付款码”获取设备（如扫码枪）读取用户手机支付宝的付款码信息后，将二维码或条码信息通过本接口上送至支付宝发起支付。
注意:

请根据接入的具体产品参考对应场景描述和示例代码

当面付产品对于未获取到明确支付成功结果的交易请务必调用撤销接口

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/trade/pay' \
--header 'Content-Type: application/json' \
--data-raw ''

响应示例

200 - 成功示例

{
  "trade_no": "2013112011001004330000121536",
  "out_trade_no": "6823789339978248",
  "buyer_logon_id": "159****5620",
  "total_amount": 120.88,
  "receipt_amount": "88.88",
  "buyer_pay_amount": 8.88,
  "point_amount": 8.12,
  "invoice_amount": 12.5,
  "gmt_payment": "2014-11-27 15:45:57",
  "fund_bill_list": [
    {
      "fund_channel": "ALIPAYACCOUNT",
      "amount": 10,
      "real_amount": 11.21
    }
  ],
  "store_name": "证大五道口店",
  "discount_goods_detail": "[{\"goods_id\":\"STANDARD1026181538\",\"goods_name\":\"雪碧\",\"discount_amount\":\"100.00\",\"voucher_id\":\"2015102600073002039000002D5O\"}]",
  "buyer_user_id": "2088101117955611",
  "async_payment_mode": "SYNC_DIRECT_PAY",
  "voucher_detail_list": [
    {
      "id": "2015102600073002039000002D5O",
      "name": "XX超市5折优惠",
      "type": "ALIPAY_FIX_VOUCHER",
      "amount": 10,
      "merchant_contribute": 9,
      "other_contribute": 1,
      "memo": "学生专用优惠",
      "template_id": "20171030000730015359000EMZP0",
      "purchase_buyer_contribute": 2.01,
      "purchase_merchant_contribute": 1.03,
      "purchase_ant_contribute": 0.82
    }
  ],
  "advance_amount": "88.8",
  "auth_trade_pay_mode": "CREDIT_PREAUTH_PAY",
  "mdiscount_amount": "88.88",
  "discount_amount": "88.88",
  "credit_pay_mode": "creditAdvanceV2",
  "credit_biz_order_id": "ZMCB99202103310000450000041833",
  "enterprise_pay_info": {
    "is_use_enterprise_pay": false,
    "invoice_amount": 80,
    "biz_info": "{\\\"enterprisePayAmount\\\":\\\"0.64\\\"}"
  },
  "can_turn_to_app_pay": "true",
  "hyb_amount": "10.24",
  "bkagent_resp_info": {
    "bindtrx_id": "123412341234",
    "bindclrissr_id": "01",
    "bindpyeracctbk_id": "123123123123",
    "bkpyeruser_code": "123451234512345",
    "estter_location": "+37.28/-121.268"
  },
  "charge_info_list": {
    "charge_fee": 0.01,
    "original_charge_fee": 0.01,
    "switch_fee_rate": "0.03",
    "is_rating_on_trade_receiver": "Y",
    "is_rating_on_switch": "Y",
    "charge_type": "trade",
    "sub_fee_detail_list": [
      {
        "charge_fee": 0.1,
        "original_charge_fee": 0.2,
        "switch_fee_rate": "0.03"
      }
    ]
  }
}

请求参数

Body 参数application/json

agreement_params

object (AgreementParams)

可选

agreement_no

string

可选

支付宝系统中用以唯一标识用户签约记录的编号（用户签约成功后的协议号）

示例值:

20170322450983769228

apply_token

string

可选

鉴权申请token，其格式和内容，由支付宝定义。在需要做支付鉴权校验时，该参数不能为空。

示例值:

MDEDUCT0068292ca377d1d44b65fa24ec9cd89132f

auth_confirm_no

string

可选

鉴权确认码，在需要做支付鉴权校验时，该参数不能为空

示例值:

423979

deduct_permission

string

商户代扣扣款许可

可选

示例值:

2021571176714791277815457854545

bkagent_req_info

object (BkAgentReqInfo)

可选

acq_code

string

可选

收单机构在清算组织登记或分配的机构代码

device_type

string

可选

终端设备类型，受理方可参考终端注册时的设备类型填写。

location

string

可选

终端设备实时经纬度信息，格式为纬度/经度，+表示北纬、东经，-表示南纬、西经。

merch_code

string

可选

收单机构在清算组织登记的商户编码

serial_num

string

可选

终端类型填写为 02、 03、04、05、06、08、09 或 10 时，必须填写终端序列号。

business_params

object (BusinessParams)

可选

actual_order_time

string

可选

实际订单时间，在乘车码场景，传入的是用户刷码乘车时间

campus_card

string

校园卡编号

可选

card_type

string

虚拟卡卡类型

可选

enterprise_pay_amount

string

可选

因公付金额，单位：元。

enterprise_pay_info

string

因公付业务信息

可选

good_taxes

string

可选

商户传入的交易税费。需要落地风控使用

mc_create_trade_ip

string

可选

商户端创建订单的 IP，须上传正确的用户端外网 IP，支持 ipv4/ipv6 格式； mc_create_trade_ip和mcCreateTradeIp（旧）参数描述相同，首选mc_create_trade_ip入参，请勿重复入参；如已入参mcCreateTradeIp（旧），无需新增入参mc_create_trade_ip。

tiny_app_merchant_biz_type

string

可选

当需要在商家平台（b.alipay.com）—数据中心中查看对应业务场景下的数据明细可以通过该参数传入支持传入的值：小程序细分业务场景

ext_user_info

object (ExtUserInfo)

可选

cert_no

string

可选

买家证件号。注：need_check_info=T或fix_buyer=T时该参数才有效，支付宝会比较买家在支付宝留存的证件号码与该参数传入的值是否匹配。

cert_type

string

可选

指定买家证件类型。枚举值： IDENTITY_CARD：身份证； PASSPORT：护照； OFFICER_CARD：军官证； SOLDIER_CARD：士兵证； HOKOU：户口本。如有其它类型需要支持，请与蚂蚁金服工作人员联系。注： need_check_info=T或fix_buyer=T时该参数才有效，支付宝会比较买家在支付宝留存的证件类型与该参数传入的值是否匹配。

fix_buyer

string

可选

是否强制校验买家身份。需要强制校验传：T; 不需要强制校验传：F或者不传；当传T时，接口上必须指定cert_type、cert_no和name信息且支付宝会校验传入的信息跟支付买家的信息都匹配，否则报错。默认为不校验。

identity_hash

string

可选

买家加密身份信息。当指定了此参数且指定need_check_info=T时，支付宝会对买家身份进行校验，校验逻辑为买家姓名、买家证件号拼接后的字符串，以sha256算法utf-8编码计算hash，若与传入的值不匹配则会拦截本次支付。注意：如果同时指定了用户明文身份信息（name，cert_type，cert_no中任意一个），则忽略identity_hash以明文参数校验。

min_age

string

可选

允许的最小买家年龄。买家年龄必须大于等于所传数值注： 1. need_check_info=T时该参数才有效 2. min_age为整数，必须大于等于0

mobile

string

可选

指定买家手机号。注：该参数暂不校验

name

string

可选

指定买家姓名。注： need_check_info=T或fix_buyer=T时该参数才有效

need_check_info

string

可选

是否强制校验买家信息；需要强制校验传：T; 不需要强制校验传：F或者不传；当传T时，支付宝会校验支付买家的信息与接口上传递的cert_type、cert_no、name或age是否匹配，只有接口传递了信息才会进行对应项的校验；只要有任何一项信息校验不匹配交易都会失败。如果传递了need_check_info，但是没有传任何校验项，则不进行任何校验。默认为不校验。

extend_params

object (ExtendParams)

可选

card_type

string

卡类型

可选

hb_fq_num

string

可选

使用花呗分期要进行的分期数

hb_fq_seller_percent

string

可选

使用花呗分期需要卖家承担的手续费比例的百分值，传入100代表100%

industry_reflux_info

string

可选

行业数据回流信息, 详见：地铁支付接口参数补充说明

royalty_freeze

string

可选

是否进行资金冻结，用于后续分账，true表示资金冻结，false或不传表示资金不冻结

specified_seller_name

string

可选

特殊场景下，允许商户指定交易展示的卖家名称

sys_service_provider_id

string

可选

系统商编号该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的PID

trade_component_order_id

string

可选

公域商品交易业务订单ID

pay_params

object (PayParams)

可选

async_type

string

可选

普通异步支付, 传入该参数时，如果满足受理条件，会先同步受理支付，然后在异步调度推进支付 NORMAL_ASYNC: 普通异步，受理成功之后，会在交易关单之前通过一定的策略重试 NEAR_REAL_TIME_ASYNC: 准实时异步，受理成功之后，会准实时发起1次调度

示例值:

NORMAL_ASYNC

retry_type

string

可选

重试类型，当async_type传入NORMAL_ASYNC时，可以设置该参数，选择是否要重试，retry_type 可选，不设置时，可重试。 ● NONE_AND_CLOSETRADE：不重试，支付请求只会被执行1次，执行完成后如果交易未成功，会关闭交易 ● NONE：不重试，支付请求只会被执行1次，执行完成后，不做任何处理。交易到达了timeout_express指定的时间后，关闭交易。 ● RETY: 重试，支付请求在超时关单前，会按照策略重试

示例值:

NONE

promo_params

object (PromoParam)

可选

actual_order_time

string

可选

存在延迟扣款这一类的场景，用这个时间表明用户发生交易的时间，比如说，在公交地铁场景，用户刷码出站的时间，和商户上送交易的时间是不一样的。

示例值:

{}

royalty_info

object (RoyaltyInfo)

可选

royalty_detail_infos

array[object (RoyaltyDetailInfos) {10}]

可选

分账明细的信息，可以描述多条分账指令，json数组。

royalty_type

string

可选

分账类型卖家的分账类型，目前只支持传入ROYALTY（普通分账类型）。

settle_info

object (SettleInfo)

可选

settle_detail_infos

array[object (SettleDetailInfo) {7}]

可选

结算详细信息，json数组，目前只支持一条。

settle_period_time

string

可选

该笔订单的超期自动确认结算时间，到达期限后，将自动确认结算。此字段只在签约账期结算模式时有效。取值范围：1d～365d。d-天。该参数数值不接受小数点。

sub_merchant

object (SubMerchant)

可选

merchant_id

string

可选

支付宝二级商户编号。间连受理商户的支付宝商户编号，通过间连商户入驻接口后由支付宝生成。直付通和机构间连业务场景下必传。

merchant_type

string

可选

二级商户编号类型。枚举值： alipay:支付宝分配的间联商户编号；目前仅支持alipay，默认可以不传。

advance_payment_type

string

可选

支付模式类型,若值为ENJOY_PAY_V2表示当前交易允许走先享后付2.0垫资

示例值:

ENJOY_PAY_V2

alipay_store_id

string

可选

支付宝店铺编号。指商户创建门店后支付宝生成的门店ID。

示例值:

2016041400077000000003314986

auth_code

string

可选

支付授权码。当面付场景传买家的付款码（25~~30开头的长度为16~~24位的数字，实际字符串长度以开发者获取的付款码长度为准）或者刷脸标识串（fp开头的35位字符串）；周期扣款或代扣场景无需传入，协议号通过agreement_params参数传递；支付宝预授权和新当面资金授权场景无需传入，授权订单号通过 auth_no字段传入。注：交易的买家与卖家不能相同。

示例值:

28763443825664394

auth_confirm_mode

string

可选

预授权确认模式。适用于支付宝预授权和新当面资金授权场景。枚举值： COMPLETE：转交易完成后解冻剩余冻结金额； NOT_COMPLETE：转交易完成后不解冻剩余冻结金额；默认值为NOT_COMPLETE。

示例值:

COMPLETE

auth_no

string

可选

资金预授权单号。支付宝预授权和新当面资金授权场景下必填。

示例值:

2016110310002001760201905725

body

string

可选

订单附加信息。如果请求时传递了该参数，将在异步通知、对账单中原样返回，同时会在商户和用户的pc账单详情中作为交易描述展示

示例值:

Iphone6 16G

buyer_id

string

可选

买家支付宝用户ID。支付宝预授权和新当面资金授权场景下必填，其它场景不需要传入。

示例值:

2088202954065786

buyer_open_id

string

可选

买家支付宝用户唯一标识

示例值:

074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5

disable_pay_channels

string

可选

禁用支付渠道。多个渠道以逗号分割，如同时禁用信用支付类型和积分，则传入："credit_group,point"。支持传入的值：渠道列表

示例值:

credit_group

discountable_amount

string

可选

可打折金额。参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。如果同时传入了【可打折金额】、【不可打折金额】和【订单总金额】，则必须满足如下条件：【订单总金额】=【可打折金额】+【不可打折金额】。如果订单金额全部参与优惠计算，则【可打折金额】和【不可打折金额】都无需传入。

示例值:

80.00

goods_detail

array[object (GoodsDetail) {11}]

可选

订单包含的商品列表信息，json格式。

alipay_goods_id

string

可选

支付宝定义的统一商品编号

body

string

商品描述信息

可选

categories_tree

string

可选

商品类目树，从商品类目根节点到叶子节点的类目id组成，类目id值使用|分割

goods_category

string

商品类目

可选

goods_id

string

可选

商品的编号，该参数传入支付券上绑定商品goods_id, 倘若无支付券需要消费，该字段传入商品最小粒度的商品ID（如：若商品有sku粒度，则传商户sku粒度的ID）

goods_name

string

商品名称

可选

out_item_id

string

可选

商家侧小程序商品ID，指商家提报给小程序商品库的商品。当前接口的extend_params.trade_component_order_id字段不为空时该字段必填，且与交易组件订单参数保持一致。了解小程序商品请参考：https://opendocs.alipay.com/pre-open/06uila?pathHash=87297d0a

out_sku_id

string

可选

price

string

商品单价，单位为元

可选

quantity

integer

商品数量

可选

show_url

string

商品的展示地址

可选

is_async_pay

boolean

可选

是否异步支付，传入true时，表明本次期望走异步支付，会先将支付请求受理下来，再异步推进。商户可以通过交易的异步通知或者轮询交易的状态来确定最终的交易结果。只在代扣场景下有效，其它场景无需传入。

示例值:

false

merchant_order_no

string

商户的原始订单号

可选

示例值:

201008123456789

notify_url

string

通知地址

可选

operator_id

string

商户操作员编号。

可选

示例值:

yx_001

out_trade_no

string

可选

商户订单号。由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。

示例值:

20150320010101001

passback_params

string

可选

公用回传参数。如果请求时传递了该参数，支付宝会在异步通知时将该参数原样返回。

示例值:

merchantBizType%3d3C%26merchantBizNo%3d2016010101111

product_code

string

可选

产品码。商家和支付宝签约的产品码。枚举值（点击查看签约情况）： FACE_TO_FACE_PAYMENT：当面付产品； CYCLE_PAY_AUTH：周期扣款产品； GENERAL_WITHHOLDING：代扣产品； PRE_AUTH_ONLINE：支付宝预授权产品； PRE_AUTH：新当面资金授权产品；默认值为FACE_TO_FACE_PAYMENT。注意：非当面付产品使用本接口时，本参数必填。请传入对应产品码。

示例值:

FACE_TO_FACE_PAYMENT

request_org_pid

string

可选

收单机构(例如银行）的标识，填写该机构在支付宝的pid。只在机构间联场景下传递该值。

示例值:

2088201916734621

scene

string

可选

支付场景。枚举值： bar_code：当面付条码支付场景； security_code：当面付刷脸支付场景，对应的auth_code为fp开头的刷脸标识串；周期扣款或代扣场景无需传入，协议号通过agreement_params参数传递；支付宝预授权和新当面资金授权场景无需传入，授权订单号通过 auth_no字段传入。默认值为bar_code。

示例值:

bar_code

seller_id

string

可选

卖家支付宝用户ID。当需要指定收款账号时，通过该参数传入，如果该值为空，则默认为商户签约账号对应的支付宝用户ID。收款账号优先级规则：门店绑定的收款账户>请求传入的seller_id>商户签约账号对应的支付宝用户ID；注：直付通和机构间联场景下seller_id无需传入或者保持跟pid一致；如果传入的seller_id与pid不一致，需要联系支付宝小二配置收款关系；支付宝预授权和新当面资金授权场景下必填。

示例值:

2088102146225135

settle_currency

string

可选

商户指定的结算币种，支持英镑：GBP、港币：HKD、美元：USD、新加坡元：SGD、日元：JPY、加拿大元：CAD、澳元：AUD、欧元：EUR、新西兰元：NZD、韩元：KRW、泰铢：THB、瑞士法郎：CHF、瑞典克朗：SEK、丹麦克朗：DKK、挪威克朗：NOK、马来西亚林吉特：MYR、印尼卢比：IDR、菲律宾比索：PHP、毛里求斯卢比：MUR、以色列新谢克尔：ILS、斯里兰卡卢比：LKR、俄罗斯卢布：RUB、阿联酋迪拉姆：AED、捷克克朗：CZK、南非兰特：ZAR、人民币：CNY

示例值:

USD

store_id

string

可选

商户门店编号。指商户创建门店时输入的门店编号。

示例值:

NJ_001

subject

string

可选

订单标题。注意：不可使用特殊字符，如 /，=，& 等。

示例值:

Iphone6 16G

terminal_id

string

商户机具终端编号。

可选

示例值:

NJ_T_001

terminal_params

string

可选

IOT设备信息。通过集成IOTSDK的机具发起的交易时传入，取值为IOTSDK生成的业务签名值。

示例值:

{"terminalType":"IOT","signature":"EXXXX","apdidToken":"iBfdgYbXXX","hardToken":"06014698AEFXXX","time":"1533061133","bizCode":"11002200020","bizTid":"0100200mWXXX","signedKeys":"authCode,totalAmount,apdidToken,hardToken,time,bizCode,bizTid"}

timeout_express

string

可选

订单相对超时时间。从交易创建时间开始计算。该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。该参数数值不接受小数点，如 1.5h，可转换为 90m。当面付场景默认值为3h；其它场景默认值为15d;

示例值:

90m

total_amount

string

可选

订单总金额。单位为元，精确到小数点后两位，取值范围：[0.01,100000000] 。

示例值:

88.88

trans_currency

string

可选

标价币种, total_amount 对应的币种单位。支持英镑：GBP、港币：HKD、美元：USD、新加坡元：SGD、日元：JPY、加拿大元：CAD、澳元：AUD、欧元：EUR、新西兰元：NZD、韩元：KRW、泰铢：THB、瑞士法郎：CHF、瑞典克朗：SEK、丹麦克朗：DKK、挪威克朗：NOK、马来西亚林吉特：MYR、印尼卢比：IDR、菲律宾比索：PHP、毛里求斯卢比：MUR、以色列新谢克尔：ILS、斯里兰卡卢比：LKR、俄罗斯卢布：RUB、阿联酋迪拉姆：AED、捷克克朗：CZK、南非兰特：ZAR、人民币：CNY

示例值:

USD

undiscountable_amount

string

可选

不可打折金额。不参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。如果同时传入了【可打折金额】、【不可打折金额】和【订单总金额】，则必须满足如下条件：【订单总金额】=【可打折金额】+【不可打折金额】。如果订单金额全部参与优惠计算，则【可打折金额】和【不可打折金额】都无需传入。

示例值:

8.88

query_options

array[string]

可选

返回参数选项。商户通过传递该参数来定制同步需要额外返回的信息字段，数组格式。包括但不限于：["fund_bill_list","voucher_detail_list","enterprise_pay_info","discount_goods_detail","discount_amount","mdiscount_amount"]

示例值:

voucher_detail_list

time_expire

string

可选

订单绝对超时时间。格式为yyyy-MM-dd HH:mm:ss。超时时间范围：1m~15d。注：time_expire和timeout_express两者只需传入一个或者都不传，如果两者都传，优先使用time_expire。

示例值:

{}

示例

返回响应

🟢200common response

application/json

Body

bkagent_resp_info

object (BkAgentRespInfo)

可选

bindclrissr_id

string

可选

枚举值，01 银联；02 网联；03 连通等

bindpyeracctbk_id

string

可选

付款机构在清算组织登记或分配的机构代码

bindtrx_id

string

原快捷交易流水号

可选

bkpyeruser_code

string

可选

用户在银行付款账号的标记化处理编号

estter_location

string

设备推测位置

可选

charge_info_list

object (ChargeInfo)

可选

charge_fee

string

实收费用

可选

charge_type

string

可选

收单手续费trade，花呗分期手续hbfq，其他手续费charge

is_rating_on_switch

string

可选

是否合约指定收费账号出资，值为"Y"或"N"

is_rating_on_trade_receiver

string

可选

是否收款账号出资，值为"Y"或"N"

original_charge_fee

string

原始费用

可选

sub_fee_detail_list

array[object (SubFee) {3}]

组合支付收费明细

可选

switch_fee_rate

string

签约费率

可选

enterprise_pay_info

object (EnterprisePayInfo)

可选

biz_info

string

因公付业务信息

可选

invoice_amount

string

开票金额

可选

is_use_enterprise_pay

boolean

是否包含因公付资产

可选

advance_amount

string

可选

先享后付2.0垫资金额,不返回表示没有走垫资，非空表示垫资支付的金额

示例值:

88.8

async_payment_mode

string

可选

异步支付模式，目前有五种值： ASYNC_DELAY_PAY(异步延时付款); ASYNC_REALTIME_PAY(异步准实时付款); SYNC_DIRECT_PAY(同步直接扣款); NORMAL_ASYNC_PAY(纯异步付款); QUOTA_OCCUPYIED_ASYNC_PAY(异步支付并且预占了先享后付额度);

示例值:

SYNC_DIRECT_PAY

auth_trade_pay_mode

string

可选

预授权支付模式，该参数仅在信用预授权支付场景下返回。信用预授权支付：CREDIT_PREAUTH_PAY

示例值:

CREDIT_PREAUTH_PAY

business_params

string

可选

商户传入业务信息，具体值要和支付宝约定将商户传入信息分发给相应系统，应用于安全，营销等参数直传场景格式为json格式

示例值:

{"data":"123"}

buyer_logon_id

string

买家支付宝账号

可选

示例值:

159****5620

buyer_open_id

string

可选

买家支付宝用户唯一标识

示例值:

074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5

buyer_pay_amount

string

买家付款的金额

可选

示例值:

8.88

buyer_user_id

string

可选

买家在支付宝的用户id

示例值:

2088101117955611

buyer_user_name

string

可选

买家名称；买家为个人用户时为买家姓名，买家为企业用户时为企业名称；默认不返回该信息，需与支付宝约定后配置返回；

示例值:

菜鸟网络有限公司

buyer_user_type

string

买家用户类型。

可选

示例值:

PRIVATE

can_turn_to_app_pay

string

可选

是否可以转为app支付，仅当商户代扣失败场景才会返回该字段信息

示例值:

true

card_balance

string

支付宝卡余额

可选

示例值:

98.23

charge_amount

string

可选

该笔交易针对收款方的收费金额；只在机构间联模式下返回，其它场景下不返回该字段；

示例值:

8.88

charge_flags

string

可选

费率活动标识。当交易享受特殊行业或活动费率时，返回该场景的标识。具体场景如下： trade_special_00：订单优惠费率； industry_special_on_00：线上行业特殊费率0； industry_special_on_01：线上行业特殊费率1； industry_special_00：线下行业特殊费率0； industry_special_01：线下行业特殊费率1； bluesea_1：蓝海活动优惠费率标签；注：只在机构间联模式下返回，其它场景下不返回该字段；

示例值:

industry_special_00

credit_biz_order_id

string

可选

信用业务单号。信用支付场景才有值。先用后付产品里是芝麻订单号。

示例值:

ZMCB99202103310000450000041833

credit_pay_mode

string

可选

信用支付模式。表示订单是采用信用支付方式（支付时买家没有出资，需要后续履约）。"creditAdvanceV2"表示芝麻先用后付模式，用户后续需要履约扣款。此字段只有信用支付场景才有值，商户需要根据字段值单独处理。此字段以后可能扩展其他值，建议商户使用白名单方式识别，对于未识别的值做失败处理，并联系支付宝技术支持人员。

示例值:

creditAdvanceV2

discount_amount

string

平台优惠金额

可选

示例值:

88.88

discount_goods_detail

string

可选

本次交易支付所使用的单品券优惠的商品优惠信息。只有在query_options中指定时才返回该字段信息。

示例值:

[{"goods_id":"STANDARD1026181538","goods_name":"雪碧","discount_amount":"100.00","voucher_id":"2015102600073002039000002D5O"}]

fund_bill_list

array[object (TradeFundBill) {5}]

可选

交易支付使用的资金渠道。只有在签约中指定需要返回资金明细，或者入参的query_options中指定时才返回该字段信息。

amount

string

可选

该支付工具类型所使用的金额。单位：元。

bank_code

string

可选

银行卡支付时的银行代码

fund_channel

string

可选

交易使用的资金渠道，详见支付渠道列表

fund_type

string

可选

渠道所使用的资金类型,目前只在资金渠道(fund_channel)是银行卡渠道(BANKCARD)的情况下才返回该信息

real_amount

string

渠道实际付款金额

可选

hyb_amount

string

惠营宝回票金额

可选

示例值:

10.24

invoice_amount

string

可选

交易中可给用户开具发票的金额

示例值:

12.50

mdiscount_amount

string

商家优惠金额

可选

示例值:

88.88

open_id

string

可选

买家支付宝用户号,该参数已废弃，请不要使用

示例值:

2088102122524333

out_trade_no

string

商户订单号

可选

示例值:

6823789339978248

pay_amount

string

支付币种订单金额

可选

示例值:

580.04

pay_currency

string

支付币种

可选

示例值:

CNY

point_amount

string

可选

使用集分宝付款的金额

示例值:

8.12

receipt_amount

string

实收金额

可选

示例值:

88.88

receipt_currency_type

string

可选

收款资金类型，当交易收款资金为数字人民币时返回值为“DC”，否则不返回该字段。

示例值:

settle_amount

string

结算币种订单金额

可选

示例值:

88.88

settle_currency

string

可选

商户指定的结算币种，目前支持英镑：GBP、港币：HKD、美元：USD、新加坡元：SGD、日元：JPY、加拿大元：CAD、澳元：AUD、欧元：EUR、新西兰元：NZD、韩元：KRW、泰铢：THB、瑞士法郎：CHF、瑞典克朗：SEK、丹麦克朗：DKK、挪威克朗：NOK、马来西亚林吉特：MYR、印尼卢比：IDR、菲律宾比索：PHP、毛里求斯卢比：MUR、以色列新谢克尔：ILS、斯里兰卡卢比：LKR、俄罗斯卢布：RUB、阿联酋迪拉姆：AED、捷克克朗：CZK、南非兰特：ZAR、人民币：CNY

示例值:

USD

settle_trans_rate

string

可选

结算币种兑换标价币种汇率

示例值:

settlement_id

string

可选

支付清算编号，用于清算对账使用；只在机构间联模式下返回，其它场景下不返回该字段；

示例值:

2018101610032004620239146945

store_name

string

可选

发生支付交易的商户门店名称

示例值:

证大五道口店

total_amount

string

交易金额

可选

示例值:

120.88

trade_no

string

支付宝交易号

可选

示例值:

2013112011001004330000121536

trans_currency

string

可选

标价币种, total_amount对应的币种单位。目前支持英镑：GBP、港币：HKD、美元：USD、新加坡元：SGD、日元：JPY、加拿大元：CAD、澳元：AUD、欧元：EUR、新西兰元：NZD、韩元：KRW、泰铢：THB、瑞士法郎：CHF、瑞典克朗：SEK、丹麦克朗：DKK、挪威克朗：NOK、马来西亚林吉特：MYR、印尼卢比：IDR、菲律宾比索：PHP、毛里求斯卢比：MUR、以色列新谢克尔：ILS、斯里兰卡卢比：LKR、俄罗斯卢布：RUB、阿联酋迪拉姆：AED、捷克克朗：CZK、南非兰特：ZAR、人民币：CNY

示例值:

USD

trans_pay_rate

string

可选

标价币种兑换支付币种汇率

示例值:

6.5261

voucher_detail_list

array[object (VoucherDetail) {12}]

可选

本交易支付时使用的所有优惠券信息。只有在query_options中指定时才返回该字段信息。

amount

string

可选

优惠券面额，它应该会等于商家出资加上其他出资方出资

string

券id

可选

memo

string

优惠券备注信息

可选

merchant_contribute

string

可选

商家出资（特指发起交易的商家出资金额）

name

string

券名称

可选

other_contribute

string

可选

其他出资方出资金额，可能是支付宝，可能是品牌商，或者其他方，也可能是他们的一起出资

other_contribute_detail

array[object (ContributeDetail) {2}]

可选

优惠券的其他出资方明细

purchase_ant_contribute

string

可选

如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时平台优惠的金额

purchase_buyer_contribute

string

可选

如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时用户实际付款的金额

purchase_merchant_contribute

string

可选

如果使用的这张券是用户购买的，则该字段代表用户在购买这张券时商户优惠的金额

template_id

string

券模板id

可选

type

string

券类型

可选

gmt_payment

string

交易支付时间

可选

示例值:

{}

🔴500请求失败

修改于 2023-11-23 02:54:33

资金授权操作查询接口

统一收单交易查询