Internal Domestic Transfer

Allows you to transfer money between accounts in the same country while maintaining the currency of origin.

Domestic Transfer

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

This reques allows you to transfer money from one account to another, within the same country

Headers

Name	Type	Description
Authorization*	String	Mandatory. JWT token in format Bearer eyJ0... . For more information about authentication, please refer to Authentication

Request Body

Name	Type	Description
transactionType*	String	Mandatory. Values: InternalDomesticTransfer
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
accountNumber*	String	Mandatory Account number to
to*	OBJECT	Account number to

200: OK

{
    "transactionType": "InternalDomesticTransfer",
    "externalId": "111111",
    "internalId": "11b1c11e-a111-1be1-ac11-ec1111111fc1",
    "country": "ARG",
    "currency": "ARS",
    "clientCode": "1111",
    "creationDate": "2023-03-21T19:28:10.630+00:00",
    "errors": [],
    "status": {
        "code": "111",
        "description": "COMPLETED",
        "detail": "Completed"
    },
    "amount": 10,
    "client": {
        "type": "Client",
        "from": {
            "clientCode": "1111",
            "date": null,
            "accountNumber": "111.111.11111111",
            "externalId": null
        },
        "to": {
            "clientCode": null,
            "date": null,
            "accountNumber": "111.111.11111111",
            "externalId": null,
            "amount": 8.7
        }
    },
    "fees": {
        "description": "Fee",
        "currency": "ARS",
        "fxSource": 204.516174,
        "fxQuote": 1.0,
        "amount": 1.2,
        "account": "111.111.11111111"
    },
    "localTaxes": [
        {
            "code": "1111",
            "percentage": 1.0,
            "description": "AGP",
            "currency": "ARS",
            "fxSource": 204.516174,
            "fxQuote": 0.0,
            "amount": 0.1,
            "account": "111.111.11111111"
        }
    ],
    "confirmed": {
        "currency": "ARS",
        "fxQuote": 1.0,
        "amount": 10.0
    },
    "payment": {
        "fxQuote": 0.0,
        "creditedAmount": 0.0,
        "amount": 10.0,
        "currency": "ARS"
    },
    "withHoldings": []
}

Example

Request

curl --location \
--request POST '{{api_environment_url}}/api/internal-transfer' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data {
  "externalId": "111222",
  "country": "ARG",
  "currency": "ARS",
  "amount": 100,
  "transactionType": "InternalDomesticTransfer",
  "client": {
    "type": "Client",
    "from": {
      "accountNumber": "032.032.00000078"
    },
    "to": {
      "accountNumber": "032.032.00000079"
    }
  }
}'

Status Ok

{
  "transactionType": "InternalDomesticTransfer",
  "externalId": "111222",
  "internalId": "fc2c831c-d0f1-41f6-8a59-0ecd426c087d",
  "country": "ARG",
  "currency": "ARS",
  "clientCode": "0001",
  "creationDate": "2023-03-23T00:27:49.509+00:00",
  "errors": [],
  "status": {
    "code": "200",
    "description": "COMPLETED",
    "detail": "INTERNAL TRANSFER"
  },
  "amount": 100,
  "client": {
    "type": "Client",
    "from": {
      "accountNumber": "032.032.00000078"
    },
    "to": {
      "accountNumber": "032.032.00000079",
      "amount": 95.8
    }
  },
  "fees": {
    "description": "Fee",
    "currency": "ARS",
    "amount": 3,
    "account": "032.032.00000078"
  },
  "localTaxes": [
    {
      "code": "0001",
      "percentage": 1.2,
      "description": "IDC",
      "currency": "ARS",
      "amount": 1.2,
      "account": "032.032.00000078"
    }
  ],
  "withHoldings": []
}

Bad Request

{
  "externalId": "111222",
  "internalId": "fc2c831c-d0f1-41f6-8a59-0ecd426c087d5",
  "errors": [
    {
      "code": "702",
      "detail": "This account doesn't have a InternalDomesticTransfer configuration for this"
    },
    {
      "code": "703",
      "detail": "Accounts countries must be match"
    }
  ],
  "status": {
    "code": "702",
    "description": "REJECTED",
    "detail": "This account doesn't have a InternalDomesticTransfer configuration for this"
  }
}

Dashboard V3

Create an internal domestic Transfer in the V3 dashboard