Code Example - Java

Code Example - Java

JAVA

Edit

main.java

  1. CTPaymentClient restv1Client = new CTPaymentClient("https://test.api.payfacto.com/", "00000000000000000000000000000000000" );


  4. // PURCHASE EXAMPLE
  5. HashMap<String, String> params = new HashMap<String, String>();
  6. params.put(CTPRequestFields.COMPANY_NUMBER, cie);
  7. params.put(CTPRequestFields.MERCHANT_NUMBER, merc);
  8. params.put(CTPRequestFields.CUSTOMER_NUMBER, cust);
  9. params.put(CTPRequestFields.AMOUNT, amount);
  10. params.put(CTPRequestFields.INVOICE_NUMBER, bill);
  11. params.put(CTPRequestFields.ORIGINAL_INVOICE_NUMBER, origBill);
  12. params.put(CTPRequestFields.INPUT_TYPE, input);
  13. params.put(CTPRequestFields.CARD_TYPE, cardType);
  14. params.put(CTPRequestFields.CARD_NUMBER, cardNumber);
  15. params.put(CTPRequestFields.EXPIRATION_DATE, expi);
  16. params.put(CTPRequestFields.CVV2CVC2_NUMBER, cvv2);
  17. params.put(CTPRequestFields.MERCHANT_TERMINAL_NUMBER, tpv);
  18. params.put(CTPRequestFields.LANGUAGE_CODE, lang);
  19. params.put(CTPRequestFields.CURRENCY_CODE, curr);
  20. params.put(CTPRequestFields.OPERATOR_ID, oper);


  23. TransactionOutput transactionOutputRestV1 = restv1Client.purchase("v1", params);

  25. if(transactionOutputRestV1 != null && transactionOutputRestV1.getReturnCode().equals("  00")) {
  26.   HashMap<String, String> paramsACK = new HashMap<String, String>();
  27.   paramsACK.put(CTPRequestFields.COMPANY_NUMBER, cie);
  28.   paramsACK.put(CTPRequestFields.MERCHANT_NUMBER, merc);
  29.   paramsACK.put(CTPRequestFields.TRANSACTION_NUMBER, transactionOutputRestV1.getTransactionNumber());
  30.   
  31.   AckOutput ackOutput = restv1Client.ack("v1", paramsACK);
  32.   //Validate ACK Results: Must be "true"
  33. }

  35. // REDIRECTION EXAMPLE
  36. HashMap<String, String> params = new HashMap<String, String>();
  37. params.put(CTPRequestFields.COMPANY_NUMBER, cie);
  38. params.put(CTPRequestFields.MERCHANT_NUMBER, merc);
  39. params.put(CTPRequestFields.CUSTOMER_NUMBER, cust);
  40. params.put(CTPRequestFields.AMOUNT, amount);
  41. params.put(CTPRequestFields.INVOICE_NUMBER, bill);
  42. params.put(CTPRequestFields.INPUT_TYPE, input);
  43. params.put(CTPRequestFields.MERCHANT_TERMINAL_NUMBER, tpv);
  44. params.put(CTPRequestFields.LANGUAGE_CODE, lang);
  45. params.put(CTPRequestFields.CURRENCY_CODE, curr);
  46. params.put(CTPRequestFields.OPERATOR_ID, oper);
  47. params.put(CTPRequestFields.SUCCESS_URL, successURL);
  48. params.put(CTPRequestFields.FAILURE_URL, failureURL);



  52. TransactionOutput transactionOutputRestV1 = restv1Client.createRedirectionSession("v1", params);


  55. if(transactionOutputRestV1 != null && transactionOutputRestV1.getReturnCode().equals("5000")) {
  56. // Perform browser redirection to
  57. // "https://test.form.payfacto.com/redirect/Redirect?SecureID=" + transactionOutputRestV1.getSecureID() + "&SecureTYPE=GET"
  58. }

  60. //On success or Failure Callback
  61. HashMap<String, String> params = new HashMap<String, String>();
  62. params.put(CTPRequestFields.COMPANY_NUMBER, cie);
  63. params.put(CTPRequestFields.MERCHANT_NUMBER, merc);
  64. params.put(CTPRequestFields.SECURE_ID, secureID);

  66. TransactionOutput transactionOutputRestV1 = restv1Client.getRedirectResponse("v1", params);

  68. if(transactionOutputRestV1 != null && transactionOutputRestV1.getReturnCode().equals("  00")) {
  69.   HashMap<String, String> paramsACK = new HashMap<String, String>();
  70.   paramsACK.put(CTPRequestFields.COMPANY_NUMBER, cie);
  71.   paramsACK.put(CTPRequestFields.MERCHANT_NUMBER, merc);
  72.   paramsACK.put(CTPRequestFields.TRANSACTION_NUMBER, transactionOutputRestV1.getTransactionNumber());
  73.   
  74.   AckOutput ackOutput = restv1Client.ack("v1", paramsACK);
  75.   //Validate ACK Results: Must be "true"
  76. }
  77. </payfacto-code>

  79. ==== CTPaymentClient.java ====
  80. <payfacto-code lang="java">
  81. public class CTPaymentClient {

  83.   private Logger logger = Logger.getRootLogger();

  85.  private static final String ACK  = "/ack";
  86.  private static final String NACK  = "/nack";
  87.  private static final String PURCHASE  = "/purchase";
  88.  private static final String PURCHASE_WITH_TOKEN = "/purchaseWithToken";  
  89.  private static final String REFUND = "/refund";
  90.  private static final String REFUND_WITHOUT_CARD = "/refundWithoutCard"; 
  91.  private static final String REFUND_WITH_TOKEN = "/refundWithToken"; 
  92.  private static final String PRE_AUTHORIZATION = "/preAuthorization"; 
  93.  private static final String PRE_AUTH_WITH_TOKEN = "/preAuthorizationWithToken"; 
  94.  private static final String COMPLETION = "/completion"; 
  95.  private static final String STANDALONE_COMPLETION = "/standaloneCompletion"; 
  96.  private static final String CASH = "/cash"; 
  97.  private static final String VERIFY_ACCOUNT = "/verifyAccount"; 
  98.  private static final String FORCE_POST = "/forcePost"; 
  99.  private static final String VOID = "/void"; 
  100.  private static final String TOTAL_BATCH = "/totalBatch"; 
  101.  private static final String CLOSE_BATCH = "/closeBatch"; 
  102.  private static final String IOP_PURCHASE = "/iopPurchase"; 
  103.  private static final String IOP_REFUND = "/iopRefund"; 
  104.  private static final String RECOVER = "/recover"; 
  105.  private static final String REDIRECT_CREATE_SESSION_PURCHASE = "/redirect/CreatePurchaseSession"; 
  106.  private static final String REDIRECT_CREATE_SESSION_PREAUTH = "/redirect/CreatePreAuthSession"; 
  107.  private static final String REDIRECT_RESPONSE = "/redirect/GetResponse"; 
  108.  private static final String RECUR_ADD_USER = "/recur/AddUser"; 
  109.  private static final String RECUR_MOD_USER = "/recur/ModUser"; 
  110.  private static final String RECUR_DEL_USER = "/recur/DelUser"; 
  111.  private static final String RECUR_INFO_USER = "/recur/InfoUser"; 
  112.  private static final String RECUR_VERIFY_USER = "/recur/VerifyUser"; 
  113.  private static final String RECUR_ADD_SUBSCRIPTION = "/recur/AddSubscription"; 
  114.  private static final String RECUR_MOD_SUBSCRIPTION = "/recur/ModSubscription"; 
  115.  private static final String RECUR_DEL_SUBSCRIPTION = "/recur/DelSubscription"; 
  116.  private static final String RECUR_INFO_SUBSCRIPTION = "/recur/InfoSubscription"; 
  117.  private static final String RECUR_MOD_INVOICE = "/recur/ModInvoice"; 
  118.  private static final String RECUR_INFO_INVOICE = "/recur/InfoInvoice"; 
  119.  private static final String RECUR_CREATE_SESSION = "/recur/CreateSession"; 
  120.  private static final String RECUR_RESPONSE = "/recur/GetResponse"; 
  121.  private static final String RECUR_ACK = "/recur/ack"; 
  122.  private static final String RECUR_NACK = "/recur/nack";  


  125.   private String hostname;
  126.   private String authApiKey;
  127.   
  128.   public CookieStore cookieStore = new BasicCookieStore();
  129.   public HttpContext httpContext = new BasicHttpContext();    
  130.   
  131.   int CONNECTION_TIMEOUT_MS = 180 * 1000; // Timeout in millis.
  132.   RequestConfig requestConfig = RequestConfig.custom()
  133.       .setConnectionRequestTimeout(CONNECTION_TIMEOUT_MS)
  134.       .setConnectTimeout(CONNECTION_TIMEOUT_MS)
  135.       .setSocketTimeout(CONNECTION_TIMEOUT_MS)
  136.       .build();


  139.   public CTPaymentClient(String hostname_, String authApiKey_) {
  140.     this.hostname = hostname_;
  141.     this.authApiKey = authApiKey_;
  142.   }

  144.   public AckOutput ack(String version_, HashMap<String, String> _params) {
  145.     return requestAckOutput("/"+ version_ +ACK, _params);
  146.   }  
  147.   
  148.   public NAckOutput nack(String version_, HashMap<String, String> _params) {
  149.     return requestNAckOutput("/"+ version_ +NACK, _params);
  150.   }  
  151.   
  152.   public TransactionOutput purchase (String version_, Map<String, String> params_)  {
  153.     return requestTransactionOutput("/"+ version_ +PURCHASE, params_);
  154.   }
  155.   
  156.   public TransactionOutput createRedirectionSession (String version_, Map<String, String> params_)  {
  157.     return requestTransactionOutput("/"+ version_ +REDIRECT_CREATE_SESSION_PURCHASE, params_);
  158.   }
  160. public TransactionOutput getRedirectResponse (String version_, Map<String, String> params_)  {
  161.     return requestTransactionOutput("/"+ version_ +REDIRECT_RESPONSE, params_);
  162.   }
  163.     
  164.   private StringBuilder requestGeneric(String path_, Map<String, String> params_)
  165.       throws UnsupportedEncodingException, IOException, ClientProtocolException {
  166.     List <NameValuePair> nvps = new ArrayList <NameValuePair>();
  167.     nvps.add(new BasicNameValuePair("auth-api-key", authApiKey));

  169.     StringBuffer paramToEncode = new StringBuffer();  
  170.     boolean isFirst = true;
  171.     if (params_ != null) {
  172.       for (String key : params_.keySet()) {
  173.         if (! isFirst) {
  174.           paramToEncode.append("&");          
  175.         }
  176.         paramToEncode.append( key + "=" + String.valueOf(params_.get(key)));
  177.         isFirst = false;
  178.       }
  179.     }
  180.     nvps.add(new BasicNameValuePair("payload", Base64.getEncoder().encodeToString( paramToEncode.toString().getBytes())));

  182.     
  183.     HttpClient client = HttpClientBuilder.create().disableRedirectHandling().build();  
  184.     httpContext.setAttribute(HttpClientContext.COOKIE_STORE, cookieStore);


  187.     HttpPost postRequest = new HttpPost(hostname + path_);
  188.     postRequest.setConfig(requestConfig);
  189.     postRequest.setHeader(HttpHeaders.ACCEPT, "application/json");
  190.     postRequest.setEntity(new UrlEncodedFormEntity(nvps));    
  191.     HttpResponse httpResponse = client.execute(postRequest, httpContext);
  192.     
  193.     
  194.     BufferedReader in = new BufferedReader(new InputStreamReader(httpResponse.getEntity().getContent()));

  196.     StringBuilder response = new StringBuilder(); 
  197.     String line;

  199.     while ((line = in.readLine()) != null) {
  200.       response.append(line);
  201.     }

  203.     in.close();
  204.     return response;
  205.   }

  207.   private TransactionOutput requestTransactionOutput (String path_, Map<String, String> params_)  {

  209.     try {
  210.       StringBuilder response = requestGeneric(path_, params_);

  212.       // Decode JSON
  213.       ObjectMapper mapper = new ObjectMapper();
  214.       TransactionOutput obj = mapper.readValue(response.toString(), TransactionOutput.class);

  216.       return obj;
  217.     }
  218.     catch (Exception e) {
  219.       logger.error("Exception in requestPost:", e);
  220.     }
  221.     finally {

  223.     }
  224.     return null;
  225.   }




  230.   private AckOutput requestAckOutput (String path_, Map<String, String> params_)  {

  232.     try {
  233.       StringBuilder response = requestGeneric(path_, params_);

  235.       // Decode JSON
  236.       ObjectMapper mapper = new ObjectMapper();
  237.       AckOutput obj = mapper.readValue(response.toString(), AckOutput.class);

  239.       return obj;
  240.     }
  241.     catch (Exception e) {
  242.       logger.error("Exception in requestPost:", e);
  243.     }
  244.     finally {

  246.     }
  247.     return null;
  248.   }
  249.   
  250.   private NAckOutput requestNAckOutput (String path_, Map<String, String> params_)  {

  252.     try {
  253.       StringBuilder response = requestGeneric(path_, params_);

  255.       // Decode JSON
  256.       ObjectMapper mapper = new ObjectMapper();
  257.       NAckOutput obj = mapper.readValue(response.toString(), NAckOutput.class);

  259.       return obj;
  260.     }
  261.     catch (Exception e) {
  262.       logger.error("Exception in requestPost:", e);
  263.     }
  264.     finally {

  266.     }
  267.     return null;
  268.   }


  271. }
  272. </payfacto-code>

  274. ==== CTPRequestFields.java ====
  275. <payfacto-code lang="java">
  276. public final class CTPRequestFields {
  277.   
  278.   /** The TRANSACTION_NUMBER. */
  279.   public static final String TRANSACTION_NUMBER = "TransactionNumber";
  280.   
  281.   /** The COMPANY_NUMBER. */
  282.   public static final String COMPANY_NUMBER = "CompanyNumber";

  284.   /** The MERCHANT_NUMBER. */
  285.   public static final String MERCHANT_NUMBER = "MerchantNumber";

  287.   /** The CUSTOMER_NUMBER. */
  288.   public static final String CUSTOMER_NUMBER = "CustomerNumber";

  290.   /** The AMOUNT. */
  291.   public static final String AMOUNT = "Amount";

  293.   /** The INVOICE_NUMBER. */
  294.   public static final String INVOICE_NUMBER = "InvoiceNumber";

  296.   /** The ORIGINAL_INVOICE_NUMBER. */
  297.   public static final String ORIGINAL_INVOICE_NUMBER = "OriginalInvoiceNumber";

  299.   /** The INPUT_TYPE. */
  300.   public static final String INPUT_TYPE = "InputType";

  302.   /** The CARD_TYPE. */
  303.   public static final String CARD_TYPE = "CardType";

  305.   /** The CARD_NUMBER. */
  306.   public static final String CARD_NUMBER = "CardNumber";

  308.   /** The EXPIRATION_DATE. */
  309.   public static final String EXPIRATION_DATE = "ExpirationDate";

  311.   /** The CVV2CVC2_NUMBER. */
  312.   public static final String CVV2CVC2_NUMBER = "Cvv2Cvc2Number";

  314.   /** The MERCHANT_TERMINAL_NUMBER. */
  315.   public static final String MERCHANT_TERMINAL_NUMBER = "MerchantTerminalNumber";

  317.   /** The LANGUAGE_CODE. */
  318.   public static final String LANGUAGE_CODE = "LanguageCode";

  320.   /** The CURRENCY_CODE. */
  321.   public static final String CURRENCY_CODE = "CurrencyCode";  

  323.   /** The OPERATOR_ID. */
  324.   public static final String OPERATOR_ID = "OperatorID";  

  326.   /** The CARDHOLDER_ADDRESS. */
  327.   public static final String CARDHOLDER_ADDRESS = "CardHolderAddress";  

  329.   /** The CARDHOLDER_POSTALCODE. */
  330.   public static final String CARDHOLDER_POSTALCODE = "CardHolderPostalCode";  

  332.   /** The CARDHOLDER_AVV. */
  333.   public static final String CARDHOLDER_AVV = "CardHolderAVV";  

  335.   /** The XID. */
  336.   public static final String XID = "xID";  

  338.   /** The UCAF. */
  339.   public static final String UCAF = "uCAF";  

  341.   /** The USER_ECHO_DATE. */
  342.   public static final String USER_ECHO_DATA = "UserEchoData";  

  344.   /** The TRX_OPTIONS. */
  345.   public static final String TRX_OPTIONS = "TrxOption";  

  347.   /** The ORIGINAL_TRANSACTION_NUMBER. */
  348.   public static final String ORIGINAL_TRANSACTION_NUMBER = "OriginalTransactionNumber";  

  350.   /** The ORIGINAL_AUTHORIZATION_NUMBER. */
  351.   public static final String ORIGINAL_AUTHORIZATION_NUMBER = "OriginalAuthorizationNumber";  

  353.   /** The ORIGNAL_AMOUNT. */
  354.   public static final String ORIGNAL_AMOUNT = "OriginalAmount";  

  356.   /** The ORIGINAL_TERMINAL_INVOICE_NUMBER. */
  357.   public static final String ORIGINAL_TERMINAL_INVOICE_NUMBER = "OriginalTerminalInvoiceNumber";  

  359.   /** The TOKEN. */
  360.   public static final String TOKEN = "Token";  

  362.   /** The SUCCESS_URL. */
  363.   public static final String SUCCESS_URL = "SuccessURL";  

  365.   /** The FAILURE_URL. */
  366.   public static final String FAILURE_URL = "FailureURL";  

  368.   /** The EMAIL. */
  369.   public static final String EMAIL = "Email";  

  371.   /** The SESSION_ID. */
  372.   public static final String SECURE_ID = "SecureID";  

  374.   /** The IOP_ISSUER_CONFIRMATION_NUMBER. */
  375.   public static final String IOP_ISSUER_CONFIRMATION_NUMBER = "IopIssuerConfirmationNumber";  

  377.   /** The IOP_ISSUER_NAME. */
  378.   public static final String IOP_ISSUER_NAME = "IopIssuerName";  

  380.   /** The IOP_TRANSACTION_ID. */
  381.   public static final String IOP_TRANSACTION_ID = "IopTransactionId";  

  383.   /** The BATCH_NUMBER. */
  384.   public static final String BATCH_NUMBER = "BatchNumber";  

  386.   /** The RECUR_ID. */
  387.   public static final String ID = "ID";  

  389.   /** The NAME. */
  390.   public static final String NAME = "Name";  

  392.   /** The FREQUENCY. */
  393.   public static final String FREQUENCY = "Frequency";  

  395.   /** The START. */
  396.   public static final String START_DATE = "StartDate";  
  397.   
  398.   /** The FINISH. */
  399.   public static final String END_DATE = "EndDate";    

  401.   /** The NUMBER. */
  402.   public static final String NUMBER_OF_PAYMENTS = "NumberOfPayments";  

  404.   /** The ACCOUNT. */
  405.   public static final String ACCOUNT_NUMBER = "AccountNumber";  

  407.   /** The DESCRIPTION. */
  408.   public static final String DESCRIPTION = "Description";  

  410.   /** The STATUS. */
  411.   public static final String STATUS = "Status";  

  413. }

    • Related Articles

    • Code Example Microsoft .NET

      Microsoft .NET Edit main.cs PaymentTransaction paymentTransaction = new PaymentTransaction("https://test.api.payfacto.com/v1", "00000000000000000000000000000000000"); String purchaseInput = FillPurchaseInput(); transactionOutput = ...

    • Code Example : HTML - JavaScript

      form.html <html> <body> <script type="text/javascript"> function encodeString(str) { document.PURCHASE.payload.value = btoa(str); } </script> <form name="PURCHASE" action="https://test.api.payfacto.com/v1/purchase" method="POST"> auth-api-key<input ...

    • Code Example : PHP

      PHP Edit main.php <?php $payload="CompanyNumber=00000&MerchantNumber=00000000&CustomerNumber=00000000&Amount=00000001000&InvoiceNumber=505836912354&OriginalInvoiceNumber=505836912354&InputType=I&CardType= ...

    • Example Calls to the Secure Payment Application

      This page lists code examples for the various Secure Payment transactions Purchase JavaScript Intent intent = new Intent("com.payfacto.terminal.payment.PAYMENT_ACTIVITY");   intent.putExtra("TRANSACTION", "SALE"); intent.putExtra("AMOUNT", "100"); // ...

    • Credit Card Verification Code (CVV)

      Introduction This code is not found on the magnetic stripe, making it impossible for the defrauder to copy the magnetic stripe or to learn the card’s verification code. This code is not embossed on the credit card either (characters engraved in the ...