付款码支付

沙箱环境

https://sandbox.yeepay.com/yop-center

POST

/rest/v1.0/aggpay/pay

aggpay

请求参数

Header 参数

x-yop-sdk-version

string

可选

默认值:

4.0.0

Body 参数application/x-www-form-urlencoded

parentMerchantNo

string

发起方商户编号

可选

<= 11 字符

示例值:

10040012345

merchantNo

string

商户编号

可选

<= 11 字符

示例值:

10040054321

orderId

string

商户收款请求号

可选

<= 64 字符

示例值:

orderId12345

orderAmount

number

订单金额

可选

示例值:

0.01

expiredTime

string <date-time>

订单截止时间

可选

示例值:

2021-01-01 12:34:56

notifyUrl

string <url>

支付结果通知地址

可选

<= 200 字符

示例值:

https://notify.merchant.com/xxx

memo

string

对账备注

可选

<= 85 字符

goodsName

string

商品名称

可选

<= 85 字符

示例值:

旺仔牛奶

fundProcessType

string

分账订单标记

可选

示例值:

REAL_TIME

payWay

string

支付方式

可选

示例值:

MERCHANT_SCAN

channel

string

渠道类型

可选

示例值:

WECHAT

scene

string

场景

可选

示例值:

OFFLINE

authCode

string

授权码

可选

示例值:

authCode123

appId

string

微信公众号ID

可选

示例值:

appId12345

userIp

string

用户IP

可选

示例值:

123.123.123.123

terminalId

string

终端号

可选

示例值:

00000000

terminalSceneInfo

string

商家终端场景信息

可选

示例值:

{"storeId":"门店id","storeName":"门店名称","operatorId":"商户操作员编号","alipayStoreId":"支付宝的店铺编号","areaCode":"门店行政区划码","address":"门店详细地址"}

channelSpecifiedInfo

string

渠道指定支付信息

可选

示例值:

{"hbFqNum":"3","hbFqSellerPercent":"0","sysServiceProviderId":"","isEnterprisePay":"N"}

channelPromotionInfo

string

渠道优惠信息

可选

identityInfo

string

限制付款人信息

可选

示例值:

{"identityVerifyType":"Y","payerIdType":"IDENTITY_CARD","payerNumber":"234512198006252456","payerName":"名字"}

limitCredit

string

是否限制贷记卡

可选

示例值:

token

string

token

可选

示例值:

83BCDF29CFACB4411533080B67864EF8C907CCDC5E10A707C285FEA10CDB8221

uniqueOrderNo

string

易宝订单号

可选

示例值:

1012202101070000001989946571

csUrl

string <url>

清算回调地址

可选

accountLinkInfo

string

合作银行信息

可选

示例值:

{accountProvider":"BOL","token":"xxx"}

bankCode

string

银行编码

可选

示例值:

BOC

businessInfo

string

自定义参数信息

可选

ypAccountBookNo

string

记账簿编号

可选

productInfo

string

易宝营销产品信息

可选

示例值:

[{"id":"1234"}]

divideDetail

string

分账明细

可选

示例值:

[{"amount":"金额","ledgerNo":"分账商编","divideDetailDesc":"分账说明"}]

divideNotifyUrl

string

分账通知地址

可选

feeSubsidyInfo

string

手续费补贴信息

可选

示例值:

[{"subsidyMerchantNo":"10080009498","subsidyAccountType":"FEE_ACCOUNT","subsidyType":"ABSOLUTE","subsidyProportion":"","subsidyCalculateType":"SINGLE_PERCENT","subsidyPercentFee":"0.6","subsidyFixedFee":"","subsidySingleMaxFee":""}]

payMedium

string

支付媒介

可选

terminalInfo

string

终端信息

可选

channelActivityInfo

string

渠道活动信息

可选

示例值:

{"food_order_type":"QR_FOOD_ORDER"}

返回响应

🟢200成功

application/json

Body

result

object (AggpaypayPassiveOrderResponseDTOResult)

可选

code

string

返回码

可选

message

string

返回信息

可选

orderId

string

商户收款请求号

可选

uniqueOrderNo

string

易宝收款订单号

可选

bankOrderId

string

渠道侧商户请求号

可选

status

string

状态

可选

terminalPayType

string

终端授权方式

可选

paySuccessTime

string <date-time>

支付完成时间

可选

userId

string

用户ID

可选

bankId

string

付款银行

可选

transactionId

string

渠道订单号

可选

channelPromotionInfo

string

渠道优惠信息

可选

realPayAmount

number

实际支付金额

可选

channelTrxId

string

银行订单号

可选

channel

string

渠道类型

可选

payWay

string

支付方式

可选

orderAmount

number

订单金额

可选

cardType

string

卡类型

可选

示例

{
  "result": {
    "code": "string",
    "message": "string",
    "orderId": "string",
    "uniqueOrderNo": "string",
    "bankOrderId": "string",
    "status": "string",
    "terminalPayType": "string",
    "paySuccessTime": "2019-08-24T14:15:22Z",
    "userId": "string",
    "bankId": "string",
    "transactionId": "string",
    "channelPromotionInfo": "string",
    "realPayAmount": 0,
    "channelTrxId": "string",
    "channel": "string",
    "payWay": "string",
    "orderAmount": 0,
    "cardType": "string"
  }
}

🔴500服务器错误

优惠券查询接口

聚合支付统一下单