Skip to content

付款查询

当商户完成付款后,可以调用付款查询接口查询付款交易信息。

付款查询返回的交易状态及错误码,请参考【交易状态/错误码】

注意:

接口只有在交易状态为“失败”或“退票”时才会返回相应错误码。

详情参阅:接口参数

接口名称:paymentOrderQry 签名规则参见:[签名规则](https://docs.shareitpay.in/#/30?page_id=647&lang=zh-cn "签名规则") > 请求和响应数据格式:application/json

1.查询参数

参数类型是否必填最大长度描述示例值
versionStringM8接口版本。当前值为:1.11.1
keyVersionStringM8密钥版本。当前值为:11
requestTimeStringM32请求时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX2022-01-22T10:00:00.500+08:00
appIdStringM64商户应用Id,PayerMax分配给商户应用的唯一标识46153e2b787241ae8b01857bb087d1bd
merchantNoStringO32商户号,商户与PayerMax业务签约时生成的唯一标识10229810189301
+dataobjectM请求数据体
「outTradeNoStringM63原商户订单号ORDER123

2.返回参数

参数类型是否必填最大长度描述示例值
codeStringM32接口响应码,'APPLY_SUCCESS'代表接口调用成功APPLY_SUCCESS
msgStringM256响应描述,'Success.'Success
+dataObjectC返回数据体
「outTradeNoStringC63商户订单号ORDER123
「tradeNoStringC64PayerMax交易流水号20220429052556PO71330000270184
「statusStringC32交易状态,SUCCESS成功, FAILED失败 ,PENDING进行中,BOUNCEBACK退票FAILED
「transactionUtcTimeStringM32交易创建时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z2022-12-14T06:35:38 +0000
「payFinishTimeStringO32交易完成时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z2022-12-14T06:35:38 +0000
「bounceBackTimeStringO32退票时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z2022-12-14T06:35:38 +0000
「redeemCodeStringO321.FAWRY取款码,2.运营商充值PIN码FAWRY取款码:ABCD123445670,PIN码见PIN码兑换流程表
「expiryTimeStringO32订单过期时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss Z2022-12-14T06:35:38 +0000
「+tradeObjectM512交易信息
『amountStringM12商户在请求中传入的付款金额,单位元1
『currencyStringM3商户在请求中传入的付款金额对应货币代码USD
「+sourceObjectM付款信息(商户)
『amountStringM12付款方-扣款金额14551
『currencyStringM3付款方-扣款币种IDR
『exchangeRateStringO16付款币种转换为扣款币种的汇率14551.332865014
『feeStringO12付款方-手续费0
『feeCurrencyStringO3付款方-手续费币种USD
『taxStringO12付款方-税费0
『taxCurrencyStringO3付款方-税费币种USD
「+ destinationObjectM收款信息(用户)
『amountStringM12收款方-到账金额14000
『currencyStringM3收款方-到账币种IDR
『exchangeRateStringO16付款币种转换为到账币种的汇率14551.332865014
『feeStringO12收款方-手续费551
『feeCurrencyStringO3收款方-手续费币种IDR
『taxStringO12收款方-税费0
『taxCurrencyStringO3收款方-税费币种IDR
「referenceStringO512附加数据,商户上送的值USER10002
「notifyPhoneStringC32收款方通知手机号081234567890
「notifyAddressStringC64收款方通知邮件地址123456@123.com
「responseCodeStringC32订单失败错误码,,详见**[错误码列表]**AMOUNT_NOT_ENOUGH
「responseMsgStringC256订单失败错误码描述Insufficient balance

3.查询示例

请求示例:

{
    "version": "1.1",
    "keyVersion": "1",
    "requestTime": "2022-01-17T07:51:15.597+00:00",
    "appId": "a0dddd1f622243cb9aa1b676e808b5f8",
    "merchantNo": "02021382719993",
    "data": {
        "outTradeNo": "P1642410680681"
    }
}

返回示例:

{
	"code": "APPLY_SUCCESS",
	"msg": "",
	"data": {
		"outTradeNo": "P1642410680681",
		"tradeNo": "20220429052556PO71330000270184",
		"status": "SUCCESS",
		"trade": {
			"amount": "100.12",
			"currency": "IDR"
		},
		"transactionUtcTime": "2022-01-17T09:33:54.540+00:00",
		"payFinishTime": "2022-01-17T09:33:54.540+00:00",
		"bounceBackTime": "2022-01-17T09:33:54.540+00:00",
		"expiryTime": "2022-01-17T09:33:54.540+00:00",
		"redeemCode": "1234444",
		"source": {
			"amount": "100.12",
			"currency": "IDR",
			"fee": "100.12",
			"feeCurrency": "IDR",
			"tax": "100.12",
			"taxCurrency": "IDR",
			"exchangeRate": "14551.3328650147"
		},
		"destination": {
			"amount": "100.12",
			"currency": "IDR",
			"fee": "100.12",
			"feeCurrency": "IDR",
			"tax": "100.12",
			"taxCurrency": "IDR",
			"exchangeRate": "14551.3328650147"
		},
		"reference": "020213827524152",
		"notifyEmail": "123456@123.com",
		"notifyPhone": "081234567890",
		"responseCode": "AMOUNT_NOT_ENOUGH",
		"responseMsg": "Insufficient balance",
	}
}

此页面的内容有帮助吗?

感谢您帮助改进 PayerMax 产品文档!

Last updated:

Released under the MIT License.