INTERNATIONAL_TRANSFER
Definition
The INTERNATIONAL_TRANSFER Transaction type is designed to handle and record the movement of funds across international borders.
Prerequisites for Transaction creation
For the creation of a transaction in the system, it is mandatory that the involved wallet and account are in an ACTIVE status, and that there are enough funds to cover the transaction amount and any associated service fees. The related Beneficiary will need to be of type INTERNATIONAL, be in status ACTIVE and contain an active Payout Method.
Transaction Purpose
The transaction_purpose field determines the valid reasons for initiating an international transfer through our API. The table below outlines the accepted purposes by country and transaction type.
Legend:
-
P2P - Person-to-Person
-
P2B - Person-to-Business
-
B2P - Business-to-Person
-
B2B - Business-to-Business
| Purpose | Canada | Hong Kong | India | Philippines |
|---|---|---|---|---|
FAMILY_MAINTENANCE |
P2P B2P | P2P B2P | P2P | P2P |
EDUCATION |
P2P P2B B2P | P2P P2B B2P | P2P P2B B2P | P2P P2B B2P |
MEDICAL |
P2P P2B B2P | P2P P2B B2P | P2P P2B B2P | P2P P2B B2P |
TOURIST |
P2P P2B B2P | |||
PERSONAL |
P2P | P2P B2P | ||
BUSINESS |
P2B B2B | P2B B2B | P2B B2B | |
INVESTMENT |
P2B B2B | P2B B2B | P2B B2B | |
TRADES |
P2B B2B | P2B B2B | P2B B2B | |
TRANSFER_TO_NRE_ACCOUNT |
P2P B2P | |||
INVESTMENT_IN_MUTUAL_FUND_INSURANCE |
P2B | |||
INVESTMENT_THROUGH_BANK |
P2B | |||
PURCHASE_OF_REAL_ESTATE |
P2P P2B B2P | |||
EDUCATION_TUITION_BOARDING |
P2P P2B B2P | |||
HOTEL_ACCOMMODATIONS |
P2B B2B | P2B | ||
TRAVEL_AGENT |
P2P P2B B2P B2B | P2P P2B B2P | P2P P2B B2P B2B | |
UTILITY_PROVIDER |
P2B | |||
TAX_PAYMENT |
P2B B2B | P2B | P2B B2B | |
LOAN_PAYMENT_TO_BANK |
P2B | |||
PRIME_MINISTERS_NATIONAL_RELIEF_FUND |
P2B | |||
HOSPITAL_OR_MEDICAL_INSTITUTION |
P2P P2B B2P | |||
PAYMENT_FOR_SERVICE |
P2P P2B B2P B2B | |||
PAYMENT_FOR_GOODS |
B2B P2B | |||
TRADE_RELATED_SERVICES |
P2B B2B | P2B B2P | ||
TRADE_REALISATION_OF_EXPORT_BILLS |
P2B B2B | P2B | ||
TRADE_ADVANCE_RECEIPT_AGAINST_EXPORT |
P2B B2B | P2B |
Source of funds
The
source_of_funds
field determines the valid The source of funds for the transaction. This field can only be sent in specific corridors . Allowed values are
EMPLOYMENT_INCOME,OWNED_BUSINESS,FAMILY_INCOME,SAVINGS,INVESTMENTS,INHERITANCE, PROCEEDS_OF_SALE,PENSION .
Transaction status
The INTERNATIONAL_TRANSFER transaction supports the following statuses:
| Status | Description |
|---|---|
CREATED |
The transaction has been initialized in the system, serving as the inception point. |
PROCESSING |
At this stage, the transaction is in the midst of processing, typically when a ledger transaction necessitates a payment action. |
PROCESSING_PAYMENT |
The transaction has been authorized and the funds are being transferred to the international financial institution. |
COMPLETED |
Funds have settled into the international financial institution. |
FAILED |
The transaction couldn't process, typically due to payment rejection, like a declined card transaction. |
ERROR |
A system glitch or anomaly that hindered the transaction's processing. |
CANCELED_USER |
The transaction was halted either by a customer or an agent via the Portal. |
CANCELED_SYSTEM |
An automated system rule resulted in the transaction's cancellation. |
MANUAL_REVIEW |
This status signifies that the transaction is undergoing a thorough review by Alviere's compliance and risk department. |
PENDING |
The transaction is waiting for some action from the end customer. Currently only applicable in flows that require 3D-S authentication. |
REJECTED |
After manual scrutiny, the transaction was declined by the risk and fraud department. |
Status reason
INTERNATIONAL_TRANSFER transactions can present a status reason if a failure occurs due to issues with the payment method utilized for funding the transaction, and will inherit the reason from the corresponding child passthrough transaction, namely CARD_PASSTHROUGH and BANK_PASSTHROUGH. Possible status_reason values for these transactions are equivalent to the ones applicable to the LOAD_FUNDS transaction type.Other possible status reasons are below:
Here is the updated markdown table with the items in the first column enclosed in backticks:
| Status Code | Description |
|---|---|
ACCOUNT_NUMBER_INCORRECT |
The Payout method account number is incorrect or invalid. |
ACCOUNT_CLOSED |
The Beneficiary's account has been closed. |
NON_PAYMENT_ACCOUNT |
The Beneficiary's account is not eligible to receive payments. |
ACCOUNT_DETAILS_INCORRECT |
Incorrect or invalid Payout method account details provided for the transaction. |
ACCOUNT_NAME_NO_MATCH_RECEIVER |
The account name does not match the Beneficiary’s name. |
INTERNAL_ERROR |
A system error occurred within the service provider's system. |
AMOUNT_INCORRECT |
The transaction amount is incorrect or invalid. |
BANK_NAME_INCORRECT |
The bank name provided for the transaction is incorrect. |
BENEFICIARY_ID_INCORRECT |
The Beneficiary's identification is incorrect or invalid. |
BENEFICIARY_NAME_INCORRECT |
The Beneficiary's name does not match the provided details. |
BENEFICIARY_TRANSACTION_LIMIT_EXCEEDED |
The Beneficiary has exceeded their transaction limit. |
BRANCH_INCORRECT |
The branch details provided are incorrect or invalid. |
COMPLIANCE_RELATED |
The transaction failed due to compliance regulations or checks. |
CORRESPONDENT_LIMIT_EXCEEDED |
The correspondent bank's limit has been exceeded for this transaction. |
IBAN_INCORRECT |
The International Bank Account Number (IBAN) is incorrect or invalid. |
BANK_CODE_INCORRECT |
The bank code provided for the transaction is incorrect. |
PAYOUT_METHOD_INACTIVE |
The selected payout method is not currently active. |
TRANSACTION_EXPIRED |
The transaction has expired and can no longer be processed. |
BENEFICIARY_MINOR |
The Beneficiary is a minor and ineligible to receive the transaction. |
MISSING_DOCUMENTS |
Required documents for the transaction are missing. |
REFUND_REQUESTED |
A refund has been requested for the transaction. |
SANCTIONED_BANK_COUNTRY |
The transaction is blocked due to sanctions against the beneficiary's country. |
ACCOUNT_ADDRESS_INCORRECT |
The address provided for the account is incorrect or invalid. |
3DS_AUTH_REQUIRED |
The end customer needs to go through the 3D-S authentication flow in order to authorize the transaction. |
3DS_NOT_ENROLLED |
The card is not 3D Secure (3D-S) enabled. |
3DS_AUTH_FAILED |
Cardholder failed 3DS authentication. |
3DS_AUTH_EXPIRED |
Initial 3DS transaction not completed within 15 minutes. |
3DS_SYSTEM_ISSUE |
3DS system malfunction. |
3DS_AUTH_REQUIRED |
3DS authentication required. |
3DS_ERROR |
3DS authentication service provided invalid authentication result. |
