-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Adapt the library to API 002.70 of connect2pay
* Create new containers and move fields in there * Adapt and create new tests * Update dependencies versions * Bump version to 2.0.1 as backward compatibility is not preserved * Add orderId to rebill call that was added in API 002.62 * Add payment mean info stubs for WeChat and AliPay
- Loading branch information
Showing
30 changed files
with
1,803 additions
and
1,217 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,3 +4,4 @@ | |
| .project | ||
| .settings | ||
| .idea | ||
| /connect2pay-client.iml | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,84 +4,123 @@ Connect2Pay Payment Page Java Client | |
| This is the Java implementation of the Connect2pay Payment Page API. | ||
|
|
||
| The main class to use is ```Connect2payClient``` that implements all the API calls. | ||
| It requires request object as entries and returns response objects. | ||
| It requires request object as entries and returns response objects. | ||
|
|
||
| Example of a payment creation with user redirection: | ||
|
|
||
| ```java | ||
| // Process a payment of €39.99 | ||
| PaymentRequest request = new PaymentRequest(); | ||
| request.setOrderId("1234ABCD").setCurrency("EUR").setAmount(3999); | ||
| request.setShippingType(ShippingType.VIRTUAL); | ||
| request.setPaymentMode(PaymentMode.SINGLE); | ||
| // User will be redirected here when clicking on "Go back to merchant" button | ||
| request.setCtrlRedirectURL("http://my.website/somewhere"); | ||
| // The payment page will do a callback on this URL after the payment is processed | ||
| request.setCtrlCallbackURL("http://my.website/payment-callback"); | ||
|
|
||
| // Validate the request | ||
| try { | ||
| request.validate(); | ||
| } catch (BadRequestException e) { | ||
| logger.error("Ooops, an error occurred validating the payment request: " + e.getMessage()); | ||
| // Handle the error... | ||
| } | ||
|
|
||
| // Instantiate the client and send the prepare request | ||
| // Second argument is the originator ID, third one is the associated API key | ||
| Connect2payClient c2p = new Connect2payClient("https://provided.url", "123456", "GreatP4ssw0rd"); | ||
| PaymentResponse response = null; | ||
| try { | ||
| response = c2p.preparePayment(request); | ||
| } catch (Exception e) { | ||
| logger.error("Ooops, an error occurred preparing the payment: " + e.getMessage()); | ||
| // Handle the error... | ||
| } | ||
|
|
||
| if (response != null && ResultCode.SUCCESS.equals(response.getCode()) { | ||
| // Get the URL to redirect the user to | ||
| String redirectURL = response.getCustomerRedirectURL(); | ||
| if (redirectURL != null) { | ||
| // Redirect the user towards this URL, this will display the payment page | ||
| } | ||
| } else { | ||
| // Handle the failure | ||
| } | ||
| import com.payxpert.connect2pay.client.containers.Account; | ||
| import com.payxpert.connect2pay.client.containers.Order; | ||
| import com.payxpert.connect2pay.client.containers.Shipping; | ||
| import com.payxpert.connect2pay.client.containers.Shopper; | ||
| import com.payxpert.connect2pay.client.requests.PaymentRequest; | ||
| import com.payxpert.connect2pay.constants.PaymentMode; | ||
| import com.payxpert.connect2pay.constants.sca.ShippingType; | ||
| import com.payxpert.connect2pay.constants.sca.ShopperAccountAge; | ||
| import com.payxpert.connect2pay.constants.sca.ShopperAccountLastChange; | ||
|
|
||
| class TestPayment { | ||
| public void processPayment() { | ||
| // Process a payment of €39.99 | ||
| PaymentRequest request = new PaymentRequest(); | ||
| request.setCurrency("EUR").setAmount(3999); | ||
| request.setPaymentMode(PaymentMode.SINGLE); | ||
| // User will be redirected here when clicking on "Go back to merchant" button | ||
| request.setCtrlRedirectURL("http://my.website/somewhere"); | ||
| // The payment page will do a callback on this URL after the payment is processed | ||
| request.setCtrlCallbackURL("http://my.website/payment-callback"); | ||
|
|
||
| Order order = new Order(); | ||
| order.setId("1234ABCD").setShippingType(ShippingType.DIGITAL_GOODS); | ||
| Shopper shopper = new Shopper(); | ||
| shopper.setEmail("[email protected]").setFirstName("John").setLastName("Doe") | ||
| .setHomePhonePrefix("47").setHomePhone("123456789").setAddress1("Main Street 41") | ||
| .setZipcode("123456").setCity("London").setCountryCode("GB"); | ||
| Account account = new Account(); | ||
| account.setAge(ShopperAccountAge.BETWEEN_30_60_DAYS).setSuspicious(false) | ||
| .setLastChange(ShopperAccountLastChange.BETWEEN_30_60_DAYS); | ||
| shopper.setAccount(account); | ||
| Shipping shipping = new Shipping(); | ||
| shipping.setName("Jane Doe").setAddress1("Other Street, 54").setCity("London") | ||
| .setZipcode("654321").setCountryCode("GB"); | ||
|
|
||
| request.setOrder(order); | ||
| request.setShopper(shopper); | ||
| request.setShipping(shipping); | ||
|
|
||
| // Validate the request | ||
| try { | ||
| request.validate(); | ||
| } catch (BadRequestException e) { | ||
| logger.error("Ooops, an error occurred validating the payment request: " + e.getMessage()); | ||
| // Handle the error... | ||
| } | ||
|
|
||
| // Instantiate the client and send the prepare request | ||
| // Second argument is the originator ID, third one is the associated API key | ||
| Connect2payClient c2p = new Connect2payClient("https://provided.url", "123456", "GreatP4ssw0rd"); | ||
| PaymentResponse response = null; | ||
| try { | ||
| response = c2p.preparePayment(request); | ||
| } catch (Exception e) { | ||
| logger.error("Ooops, an error occurred preparing the payment: " + e.getMessage()); | ||
| // Handle the error... | ||
| } | ||
|
|
||
| if (response != null && ResultCode.SUCCESS.equals(response.getCode())) { | ||
| // Get the URL to redirect the user to | ||
| String redirectURL = response.getCustomerRedirectURL(); | ||
| if (redirectURL != null) { | ||
| // Redirect the user towards this URL, this will display the payment page | ||
| } | ||
| } else { | ||
| // Handle the failure | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| Example of the payment callback handling: | ||
|
|
||
| ```java | ||
| // Instantiate the client and handle the callback | ||
| Connect2payClient c2p = new Connect2payClient("https://provided.url", "123456", "GreatP4ssw0rd"); | ||
| PaymentStatusResponse response = null; | ||
| try { | ||
| // Request is either the body of the received request as a string or an InputStream pointing to the received body | ||
| response = c2p.handleCallbackStatus(request); | ||
| } catch (Exception e) { | ||
| logger.error("Ooops, an error occurred handling the callback: " + e.getMessage()); | ||
| // Handle the error... | ||
| } | ||
|
|
||
| if (response != null && ResultCode.SUCCESS.equals(response.getCode()) { | ||
| // Check the payment status: 000 means success | ||
| if ("000".equals(response.getErrorCode()) { | ||
| // Handle the payment success case | ||
| // ... | ||
| // Access the payment mean information | ||
| CreditCardPaymentMeanInfo pmInfo = response.getCCPaymentMeanInfo(); | ||
| logger.info("Successful payment done by " + pmInfo.getCardHolderName() + "with card " + pmInfo.getCardNumber()); | ||
| } else { | ||
| // Handle the payment failure case | ||
| } | ||
|
|
||
| if (handledSuccessfully) { | ||
| out.write(CallbackStatusResponse.getDefaultSuccessResponse().toJson()) // out is the output stream | ||
| } else { | ||
| out.write(CallbackStatusResponse.getDefaultFailureResponse().toJson()) // out is the output stream | ||
| } | ||
| } else { | ||
| // Handle the failure | ||
| out.write(CallbackStatusResponse.getDefaultFailureResponse().toJson()) // out is the output stream | ||
| } | ||
| import java.io.OutputStream; | ||
|
|
||
| class TestPayment { | ||
| private OutputStream out; | ||
|
|
||
| public void handleCallback(String request) { | ||
| // Instantiate the client and handle the callback | ||
| Connect2payClient c2p = new Connect2payClient("https://provided.url", "123456", "GreatP4ssw0rd"); | ||
| PaymentStatusResponse response = null; | ||
| try { | ||
| // Request is either the body of the received request as a string or an InputStream pointing to the received body | ||
| response = c2p.handleCallbackStatus(request); | ||
| } catch (Exception e) { | ||
| logger.error("Ooops, an error occurred handling the callback: " + e.getMessage()); | ||
| // Handle the error... | ||
| } | ||
|
|
||
| if (response != null && ResultCode.SUCCESS.equals(response.getCode())) { | ||
| // Check the payment status: 000 means success | ||
| if ("000".equals(response.getErrorCode())) { | ||
| // Handle the payment success case | ||
| // ... | ||
| // Access the payment mean information | ||
| CreditCardPaymentMeanInfo pmInfo = response.getCCPaymentMeanInfo(); | ||
| logger.info("Successful payment done by " + pmInfo.getCardHolderName() + "with card " + pmInfo.getCardNumber()); | ||
| } else { | ||
| // Handle the payment failure case | ||
| } | ||
|
|
||
| if (handledSuccessfully) { | ||
| this.out.write(CallbackStatusResponse.getDefaultSuccessResponse().toJson()); // out is the output stream | ||
| } else { | ||
| this.out.write(CallbackStatusResponse.getDefaultFailureResponse().toJson()); // out is the output stream | ||
| } | ||
| } else { | ||
| // Handle the failure | ||
| this.out.write(CallbackStatusResponse.getDefaultFailureResponse().toJson()); // out is the output stream | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.