laihaihan / java-sample-code

This repository hosts the Java sample code for the Visa Developer Platform.

Visa Developer Platform - Java Sample Code

This repository hosts the Java sample code for the Visa Developer Platform.

If you are new to the Visa Developer Platform, please take a look at our Getting Started Guide which walks you through the steps to make a basic helloworld API call.

Once you are comfortable with the same and have also explored the documentation to know about the various API that Visa exposes, you can then use the Java sample code on this site as a starting point in your journey towards building your application.

Sample code is available for the following capabilities:

• Visa Direct
• Visa Merchant Offers Resource Center
• Merchant Search

Getting Started

The instructions will guide you make the first call to VDP from your local machine for development and testing purposes.

Prerequisites

• Java JDK: (Version 1.8.0 or above)
• Build Tools: Maven (Version 3.0.5 or above)

Setup & Installation

• Configure the credentials required

Edit the file /Samples/src/main/resources/auth_config.xml to set the fields shown below. Refer the Getting Started Guide to get the credentials.

<username></username>
<password></password>
<keystore_path></keystore_path>
<keystore_password></keystore_password>
<private_key_password></private_key_password>

• You can also follow the below steps for quickly getting the credentials:

  • Login to https://developer.visa.com
  • Navigate to https://developer.visa.com/portal/#console
  • Click on create new project
  • Enter the project name and select the following products:
    • Visa Direct
    • Visa Merchant Offers Resource Center
    • Merchant Search
  • Click on create project
  • A pop-up will appear, click continue
  • Click on Download/Copy Certificate Private Key to download the key (From here on referred as privateKey.pem)
  • After the download is complete, confirm that the keys are downloaded and continue
  • Once redirected to the application page, do the following:
    • Under User ID and Password section, Note down the User ID (USERNAME)
    • Under User ID and Password section, Note down the Password (PASSWORD)
    • Under Certificates section, download the certification with the same name as that of the application (From here on referred as cert.pem)
    • Under Certificates section, download the Visa Development Platform Certificate (From here on referred as VDPCA-SBX.pem)
  • Move to your download folder (KEYSTORE_PATH) and perform the following actions to generate the jks file:
    • openssl pkcs12 -export -in cert.pem -inkey "privateKey.pem" -certfile cert.pem -out key.p12
    • Note the password asked in above step (X)
    • keytool -importkeystore -srckeystore key.p12 -srcstoretype PKCS12 -destkeystore key.jks
    • Enter the destination key store password and note it. (KYESTORE_PASSOWORD)
    • When asked for source key store password, enter X.
    • keytool -import -alias ejbca -keystore key.jks -file VDPCA-SBX.pem -storepass
    • Note the password entered in the above step. (PRIVATE_KEY_PASSWORD)

• Run the below command to install and resolve all dependencies

mvn clean install

Running the tests

mvn test -pl Samples

Built With

• Maven - Dependency Management

Versioning

1.0

For the versions available, see the releases on this repository.

Authors

Visa Developer Platform

See also the list of contributors who participated in this project.

Acknowledgments

• The following repository only serves the need of calling VDP API's from Java as sample code.