J2Pay –入门

入门将指导您如何通过非常简单的步骤快速开始使用J2pay。

下载

J2Pay在Maven上可用。

<dependency>
        <groupId>com.tranxactive</groupId>
        <artifactId>j2pay</artifactId>
        <version>2.4.0</version>
    </dependency>

您也可以在此处下载jar文件

例

在此示例中，我们将执行购买和重新计费交易。 首先，我们将获得所需的网关，即授权

Gateway gateway = GatewayFactory.getGateway(AvailableGateways.AUTHORIZE);

由于我们正在测试环境中工作，因此我们将启用测试模式。

gateway.setTestMode(true);

接下来，我们将要求该库向我们展示该网关的API参数是什么

JSONObject apiSampleParameters = gateway.getApiSampleParameters();
    System.out.println(apiSampleParameters)
    
    //output
    {"name":"also called api user name / api login id","transactionKey":"the transaction key"}

正如我们在输出中所看到的，库告诉我们Authorize网关需要两个API参数名称和transactionKey。 现在，我们将通过我们的商人值填充这些字段。

apiSampleParameters.put("name", "<your account's user name here>");
    apiSampleParameters.put("transactionKey", "<your account's transaction key here>");

接下来，我们将使用Customer和CustomerCard类将信息传递给购买方法

Customer customer = new Customer();
        
    customer
        .setFirstName("test first name")
        .setLastName("test last name")
        .setCountry(Country.US)
        .setState("TX")
        .setCity("test city")
        .setAddress("test address")
        .setZip("12345")
        .setPhoneNumber("1234567890")
        .setEmail("email@domain.com")
        .setIp("127.0.0.1");
        
    CustomerCard customerCard = new CustomerCard();
    
    customerCard
        .setName("test card name")
        .setNumber("5424000000000015") //Authorize test card
        .setCvv(123)
        .setExpiryMonth("01")
        .setExpiryYear("2022");

采购

我们都可以打电话购买

HTTPResponse purchaseResponse = gateway.purchase(apiSampleParameters, customer, customerCard, Currency.USD, 2.5f);

处理购买响应

现在我们可以检查事务是成功还是失败。

if(purchaseResponse.isSuccessful()){
        //some code
    }

要打印完整的回复，请参见下面的代码段

System.out.println(purchaseResponse.getJSONResponse());
    
    //output
    {
        "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 }
    }

注意

响应在“ API响应”部分中进行了详细定义。 对于此示例，您唯一应该知道的是网关响应分为两个键。

1. lr，图书馆回应
2. gr，网关响应

库响应仅包含库认为对您重要的值，并且对于进一步操作（如退款/无效/重新开票）很有用。 请记住，库响应已经准备了对该事务进行进一步操作所需的参数。 即退款，重新开票或作废。

重新开票

记住，我们将购买响应保存在purchaseResponse变量中。 下面的代码仅两行显示了如何执行重发票据交易。

JSONObject rebillParams = purchaseResponse.getJSONObject("lr").getJSONObject("rebillParams");    
HTTPResponse rebillResponse = gateway.rebill(apiSampleParameters, rebillParams, 50);

恭喜您获得了完整的入门指南。 请随时在info@tranxactive.com上写信给我们

您还可以在此处查看详细示例。

翻译自: https://www.javacodegeeks.com/2018/11/j2pay-getting-started.html