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响应”部分中进行了详细定义。对于此示例，您唯一应该知道的是网关响应分为两个键。

lr，图书馆回应
gr，网关响应

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

重新开票

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

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

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

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