Visa API
Direct integration with Visa-provided services — FX rate retrieval and funds-transfer enquiry — exposed through Paynetics' API.
Use these endpoints to look up Visa's published exchange rates before initiating a cross-currency transfer, and to query the status / availability of a funds transfer.
Visa API Integration — FX
POST
/v2/visa/fx
Operation
visa_fxRequest body
| Field | Type | Description |
|---|---|---|
rate_
|
string (0,any) required | |
source_
|
string (3,3) required | |
destination_
|
string (3,3) required | |
source_
|
number (0,any) | |
destination_
|
number (0,any) |
Example request
{
"rate_product_code": "A",
"source_currency_code": "840",
"destination_currency_code": "978",
"source_amount": 100,
"destination_amount": 92.5
}Response
| Field | Type | Description |
|---|---|---|
conversion_
|
string (0,any) | |
source_
|
string (0,any) | |
destination_
|
string (0,any) | |
source_
|
number (0,any) | |
destination_
|
number (0,any) |
Example response
{
"conversion_rate": "0.873598965757",
"source_currency_code": "USD",
"destination_currency_code": "EUR",
"source_amount": 100,
"destination_amount": 92.5
}Retrieve Visa's current FX rate for a currency pair before initiating a cross-currency transfer.
Visa API Integration — Transfer Enquiry
POST
/v2/visa/funds-transfer-inquiry
Operation
visa_funds_transfer_inquiryRequest body
| Field | Type | Description |
|---|---|---|
systems_
|
string (0,any) required | |
primary_
|
string (0,any) required | |
retrieval_
|
string (0,any) required |
Example request
{
"systems_trace_audit_number": "350420",
"primary_account_number": "4895142232120006",
"retrieval_reference_number": "401010350420"
}Response
| Field | Type | Description | |||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
visa_
|
array[object] | ||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||
Example response
{
"visa_network_info": [
{
"card_type_code": "D",
"billing_currency_code": 840,
"billing_currency_minor_digits": 2,
"issuer_name": "Visa Test Bank",
"card_issuer_country_code": 840,
"fast_funds_indicator": "B",
"push_funds_block_indicator": "C",
"online_gambling_block_indicator": "N"
}
]
}Query the availability or status of a Visa funds-transfer (OCT / AFT / similar) before sending the actual transaction.
Transfer Enquiry v3
POST
/v3/visa/funds-transfer-inquiry
Operation
visa_funds_transfer_inquiryRequest body
| Field | Type | Description |
|---|---|---|
systems_
|
string (0,any) required | |
primary_
|
string (0,any) required | |
retrieval_
|
string (0,any) required |
Example request
{
"systems_trace_audit_number": "350420",
"primary_account_number": "4895142232120006",
"retrieval_reference_number": "401010350420"
}Response
| Field | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
visa_
|
array[object] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Example response
{
"visa_network_info": [
{
"issuer_name": "Visa Test Bank",
"issuer_country_code": 840,
"billing_currency": 840,
"billing_currency_code_minor_digits": 2,
"card_platform_code": "D",
"card_product_type": "C",
"card_sub_type_code": "F",
"combo_card_range": "N",
"money_transfer_push_funds_domestic": "Y",
"money_transfer_push_funds_cross_border": "Y",
"money_transfer_fast_funds_domestic": "Y",
"money_transfer_fast_funds_cross_border": "Y",
"non_money_transfer_push_funds_domestic": "Y",
"non_money_transfer_push_funds_cross_border": "Y",
"non_money_transfer_fast_funds_domestic": "Y",
"non_money_transfer_fast_funds_cross_border": "Y",
"online_gambling_push_funds_domestic": "N",
"online_gambling_push_funds_cross_border": "N",
"online_gambling_fast_funds_domestic": "N",
"online_gambling_fast_funds_cross_border": "N"
}
]
}Errors
| Code | Description |
|---|---|
11000 | services.general.error |
11001 | services.general.validation_error |
21001 | services.visa.request_rejected — Visa declined the inquiry; Visa's own reason and message are returned in `errors` |