Docs play_arrow Create Project
keyboard_arrow_down

Create Project

Creating a project starts with selecting the APIs that you are going to use. Simply specify a project name and description, and then select the APIs you would like to use. Refer to Product Documentation for API reference information.

To create a project:

  1. Go to your dashboard.
  2. Click on Create New Project.
  3. Specify Project Name and Project Description (Note: This can be maximum 1000 characters).
  4. Select the APIs you are interested to use in your project.

Note: Depending on the APIs you select, you may need to submit a Certificate Signing Request (CSR). This is not required for all authentication methods.

  • Generate a CSR for me (default)

    During the creation of your project, you must be ready to save your certificate private key. This key is only available to download once. By continuing, you will be prompted to save your private key locally and your project will be registered. If you are using a Two-Way SSL authentication, refer to Configuring a Two-Way SSL Keystore Using an Auto-generated CSR section for more details.
  • Submit my own CSR

    If you are using a Two-Way SSL authentication, refer to Configuring Two-Way SSL Keystore Using Your Own CSR for more details on how to configure a Two-Way SSL Keystore with OpenSSL and your own CSR or how to configure a Two-Way SSL Keystore with Java Keytool and your own CSR.

Note: For some APIs, you may have additional Agreements (Terms and Conditions).

On your dashboard, you can find the following options:

  • Keys/APIs to access your API credentials.

    Note: Visa Developer allows you to easily generate the sample code for one of the endpoints for all the selected APIs. Before you can use your new project, you must save your certificate private key locally.

    Visa Developer generates the following types of certificates. Note: Depending on the APIs you select, you may need to submit a Certificate Signing Request (CSR). This is not required for all authentication methods.
    • Visa Developer Platform Certificate: This is a Server certificate and required for handshake (verification and validation) with Akamai. You must add this to your trust-store.
    • Geo-Trust Certificate: This is a third party issued certificate for secure connection to endpoint and required for Two-Way SSL.
    • Project Certificate: This certificate validates the project and provides permission to access the Visa Developer Resources (SBX/Cert/Prod). This has a validity period.
    • Visa Certificate for Callbacks (Two-Way SSL): This certificate type is basically required for Outbound services/APIs on Visa Developer. The service identifies this certificate as a requirement towards Two-Way SSL.
  • Configurations to configure the Outbound Callbacks, as applicable to the product that support this feature. Refer to Outbound Configuration for more details.
  • Test Data to access the test data that has been generated for you based on the APIs you selected.
  • Project Settings to configure the system settings for the APIs (if applicable).
  • Sample Code to download the 'hello world' project that comes preconfigured with your API credentials.
  • Project Promotion to go through the steps to request a move from Sandbox to Production.

When Visa Developer launches new Products or APIs, you can easily add new Products or API(s) to your existing project in the Sandbox by simply editing your existing project. You can either add Products or APIs:

  • Product(s). For example: Visa Direct, Mobile Location Confirmation, etc.
  • API(s). For example: Funds Transfer API, Get Payment Data API, Locate ATMs API, Provision Token API, Merchant Locator API, Visa Travel Notification API etc.

To add new APIs to an existing project in the Sandbox:

  1. Go to your dashboard.
  2.  Select your existing Project from My Projects.
  3. Navigate to the Keys/APIs > APIs Included section.
  4. Click on Add APIs.

Note: For some APIs, you may have additional Agreements (Terms and Conditions).

Note: Currently Delete APIs is not supported. This means, once the project is created, you cannot unregister APIs from your project in the Sandbox.

In case you have already moved (or requested) your project from Sandbox to Production, you can request to re-promote your project with the newly added APIs. Please consider the following conditions:

  • There are newly added Products or APIs in the Sandbox
  • The previous project promotion request (if any) was completely processed by Visa and the project was promoted to Production

Visa Developer Sandbox is a fully functional environment that allows you to test publicly available API endpoints. To help you develop and test your project, the Sandbox provides you with all of the testing data. You can also refer to API Explorer to experience the API Endpoint and Request/Response parameters.

On your dashboard, click the project name to access the project details.

  • Copy/paste your project keys, test data and documentation for the API project.
  • Each API has an LED indicator:
    • Green indicates you can start to invoke the API.
    • Red indicates a failure and there will be no green after this. (There is no need to wait for the status anymore. You will need to create a new project.)
    • Gray indicates that you will have to wait for the status to turn green.

        If the LEDs show Activation in progress, click on the refresh icon next to the API to obtain the status.

Once you are ready to invoke your APIs in Sandbox, refer to the following URLs:

  • For all Business-to-Business (B2B) calls — send test requests to this URL: https://sandbox.api.visa.com/
  • For all Business-to-Consumer (B2C) calls — send test requests to this URL: https://sandbox.webapi.visa.com/
  • Note: Currently, Visa Developer only provides the Flex API/Token endpoint for B2C calls.