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
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