Visa Pay
Getting Started with Visa Pay
The Visa Pay API enables secure digital wallet payment processing. It provides authentication and integration capabilities for client developers to implement payment functionality.
The API supports card enrollment, near real-time transaction authorization, and comprehensive token lifecycle management.
Prerequisites
Here is a list of requirements you need to meet before you can start using the Visa Pay API. You need to complete production integration before this information becomes useful.
- Client registration Visa, provided in partnership with the Visa Client Services team
- Completed VDP sign up with credentials have been granted Visa Pay API access
- Compliance with regional payment regulations
- TLS 1.2+ security protocol implementation
- Reviewed the Visa Pay Service Description document
- Clear definition of which Visa Pay use cases that are in scope
Control Center Setup
Visa Pay uses Pismo infrastructure for its APIs. This means clients must create an Organization within Pismo. An organization is the main object on the Pismo platform. It acts as a container that holds all programs. For more information, refer to Core objects.
Organization
The Organization ID will be issued by a Visa Pay representative. Reach out to your client account representative at Visa to request an Organization ID for Visa Pay and provide this information:
| Field | Description |
|---|---|
| Environment* | The identifier for the environment where this Org will be created. Forsandbox, this will be 'EXT' |
| Org Name* | A name to identify your Organization in the platform |
| Address | Address |
| Number | Address number |
| Complementary Address | Additional address line |
| Landmark | Reference |
| Zip Code | Post code, zip code or other postal identifier for the office address |
| City | City of address |
| State | State |
| Country | ISO 3166 country codes to represent the country (the 3-character alphabetic value) |
| Legal Representative's Name | Name of Legal Representative |
| Email * | Email of the admin user for the organization |
| Time zone (TZ Database name) | IANA database for time zones. For India, for example, you would use 'Asia/Kolkata' as the default value |
| Currency Code | ISO 4217 currency codes to represent currency (the 3-character numeric value). For example, Indian Rupees is '356' in the ISO 4217 spec |
| Document Number | Any unique identifier for your company. This is usually something like a company registration number in the country of operation |
Fields with * indicate the required fields to submit a request for org creation.
During the setup process, the Visa Pay client's administrator will receive an automated email from Pismo. The administrator will complete the setup and may invite additional team members to the tenant as necessary.
Program
You can only create a program after Visa has issued the Organization and the administrator has successfully signed in to the Control Center. You must create a program for Visa Pay as this will be a primary field used across the API calls. To create a program for Visa Pay, follow the instructions:
After you log in to the Control Center, click the "Menu" button in the top left corner.
On the Menu, click Configurations. Then, click Programs.
On the Programs screen, click Create Program
On the Program Type screen, click Debit.
Register the program with details like Currency, Time zone, Country, and BIN (start + end range). Then, click Next.
Visa Pay card configuration follows specific requirements for brand, network, and BIN settings.
- Card brand will always be Visa
- Card network integration will always be Zero balance
- For Production the BIN registered must have been provided by Visa, while for Sandbox any number can be used
- Review the details and click Finish to complete the program process.
Production BIN ranges must align to the token ranges activated in Visa for that BIN. For more information, refer to Manage Programs.