介绍
该库中的神奇之处在于,无论网关是什么,其响应都是唯一的。 了解API响应后,您便可以轻松地将此响应用于进一步的交易,例如退款,作废或重新开票。
首先,在开始阅读时,所有响应都是JSON。
所有响应均分为两个json键。
- lr(库响应)
- gr(网关响应)
因此,这是一个简单的响应。
{lr : { //library response },gr: { //gateway response}}
J2pay响应使开发人员可以轻松检查网关响应。原始网关响应包含开发人员通常不需要的太多数据。 为了简化开发人员的工作,J2pay将网关响应分为两个键lr和gr。
lr响应,这意味着库响应仅包含库认为对您很重要的值,并且对于进一步操作(如退款/无效/重新开票)很有用。
但是,您也可以在gr键中看到网关的完整响应。
图书馆回应
在本节中,我们将深入研究库响应(lr)。
库响应又分为成功和错误两个响应。 这两个都在下面列出。
首先看一下错误消息,它非常简单,仅包含两个键。 见下文。
{"lr": {"success": false,"message": "gateway error message",},"gr": { //long gateway response }}
对于所有四个事务,错误响应都将相同。
成功响应关系到四种不同的交易购买,退款,作废或重发。 但是没有重大区别。 还请记住,所有网关的成功响应均保持不变。
注意:您可以在此处查看所有示例响应。
让我们看一下购买成功响应。
{"lr": {"success": true,"message": "SUCCESS","transactionId": "3902990127","amount": 45,"cardExpiryYear": "2017","cardFirst6": "601160","cardExpiryMonth": "12","maskedCard": "601160******6611","rebillParams": {"customerVaultId": "174302554"}, "voidParams": {"transactionId": "3902990127"},"currencyCode": "USD","cardLast4": "6611","refundParams": {"transactionId": "3902990127"}},"gr": { // long gateway response }}
购买响应非常简单,您可以看到其中包含成功密钥,该密钥还让您知道交易是否成功以及网关返回的消息。 无论响应是成功还是失败,这两个键将始终显示。
如您所见,成功响应还包含transactionId。 除这三个键外,其余键不需要说明。
- voidParams
- 退款参数
- 重发Params
购买交易成功执行后,可以对该交易执行更多操作,即您可以退款,作废或重新开票(也称为重复)。
对于所有这三个操作,所有网关都需要不同的参数,一些需要transactionId,而有些则需要带有不同变量名的标记化变量。 如果开发人员正在使用多个网关,那将是头痛的事情。 但是J2pay已经通过上述购买响应中的这三个关键点解决了这些问题。
因此,例如,如果您想对先前收取的交易执行退款。 您可以按照退款交易请求中的原样传递退款参数,也可以直接将其保存在数据库中以便以后退款。 无效和重新计费也一样。 在示例响应部分中列出了所有事务的示例响应。
注意:
要查看所有响应变量, 请单击此处 。
要查看所有示例响应, 请单击此处 。
翻译自: https://www.javacodegeeks.com/2018/11/j2pay-api-responses.html