Internal Foreign Transfer

Allows you to transfer money between accounts in different countries while maintaining the original currency.

Foreign Transfer

POST {{api_environment_url}}/api/internal-transfer

Headers

Name	Type	Description
Authorization*	String

Request Body

Name	Type	Description
transactionType*	String	Mandatory. Values: InternalForeignTransfer
externalId*	String	Mandatory. An ID that is meaningful to you and your system. Must be unique
country	String	Mandatory. Your from user's country (i.e. country in which the payment will be processed), in ISO format. Please refer to Country Codes for a full list of supported countries
currency*	String	Mandatory. The currency in which the amount is expressed.
amount*	String	Mandatory. Amount to charge to your end user
client*	OBJECT	Mandatory. Part Object, Information related to accounts from and to
from*	OBJECT	Mandatory. Account number from
accountNumber*	String	Mandatory. Account number from
to*	OBJECT	Account number to
accountNumber*	String	Mandatory Account number to

Example

Request

curl --location \
--request POST '{{api_environment_url}}/api/internal-transfer' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "externalId": "111333",
    "country": "ARG",
    "currency": "USD",
    "amount": 100,
    "transactionType": "InternalForeignTransfer",
    "client": {
        "type": "Client",
        "from": {
            "accountNumber": "032.840.00000005"
        },
        "to": {
            "accountNumber": "068.840.00000001"
        }
    }
}'

Status Ok

{
    "transactionType": "InternalForeignTransfer",
    "externalId": "111333",
    "internalId": "a70674fe-b76c-4f6c-955a-7144f2f7ea1f",
    "country": "ARG",
    "currency": "USD",
    "clientCode": "0001",
    "creationDate": "2023-03-23T00:38:30.828+00:00",
    "errors": [],
    "status": {
        "code": "200",
        "description": "COMPLETED",
        "detail": "INTERNAL TRANSFER"
    },
    "amount": 100,
    "client": {
        "type": "Client",
        "from": {
            "accountNumber": "032.840.00000005"
        },
        "to": {
            "accountNumber": "068.840.00000001",
            "amount": 95.8
        }
    },
    "fees": {
        "description": "Fee",
        "currency": "USD",
        "amount": 3.0,
        "account": "032.840.00000005"
    },
    "localTaxes": [
        {
            "code": "0001",
            "percentage": 1.2,
            "description": "IDC",
            "currency": "USD",
            "amount": 1.2,
            "account": "032.840.00000005"
        }
    ],
    "withHoldings": []
}

Bad Request

{
  "externalId": "111333",
  "internalId": "a70674fe-b76c-4f6c-955a-7144f2f7ea1f",
  "errors": [
    {
      "code": "111",
      "detail": "Countries of accounts must be different."
    },
    {
      "code": "111",
      "detail": "Accounts not match with accounts client"
    }
  ],
  "status": {
    "code": "708",
    "description": "REJECTED",
    "detail": "Countries of accounts must be different."
  }
}