Wire Out

To withdraw the funds received through Localpayment and deposit them into your bank account, you can perform a 'wire out' to transfer those funds from your Localpayment account to your external bank.

There are 2 types of settlement

1.- Balance sheet settlement. It is when the money is released and passes to the balance. When AVAILABLE on the account

2.- Settlement to the client: After 15 days of a payment, that money is released to the client, but he will be able to withdraw the money when he reaches or exceeds the minimum settlement

Wire Out Flow

Here are two ways to process a Wire Out: API flow and dashboard V3 . The flow begins with the request of a Wire Out via API or dfashboard. The transaction is created with the status of Pending Authorization.

To be processed, the operation must be authorized by an external user with an administrator profile. If the operation is authorized, the transaction moves to the Received status; otherwise, it moves to the Rejected status.

Once the operation is in the Received status, the Localpayment team will validate the transaction. If everything is okay, it will move to the Pending Debit status; if the data is incorrect, the operation will be Rejected.

The Localpayment team will validate whether the transfer was completed and if the amount was transferred (Completed) or if it was rejected by the bank (Rejected). In both cases, you will receive an email notification.

Wire Out API

POST {{api_environment_url}}/api/account/wire-out

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: Wire Out
externalId*	String	Mandatory. An ID that is meaningful to you and your system. Must be unique
country*	String	Mandatory. It is from the country where the payment will be processed, in ISO format. See Country Codes for a complete list of supported countries.
currency*	String	Mandatory. The currency in which the amount is expressed.
amount*	String	Mandatory. Amount to be debited
accountNumber*	String	Mandatory. Account number
to*	OBJECT	Parameters that indicate the origin of the funds
name*	String	Mandatory. Bank name
swift*	String	Mandatory. Ordering bank identification code to make international money transfers.
address*	String	Mandatory. Bank´s address,
accountName*	String	Mandatory. Name of the holder of the ordering bank account
accountNumber*	String	Mandatory. Account number of de holder of the ordering bank
routingNumber	String	Transaction identifier code, that is, to indicate the banking entities of origin and destination of the transfers in the United States
beneficiaryAddress*	String	Mandatory. Address of the account holder of the bank

200: OK

{
    "transactionType": "WireOut",
    "externalId": "",
    "internalId": "c0e5ec40-b5b6-49aa-8c2d-b1ba01080100",
    "country": "ARG",
    "currency": "ARS",
    "clientCode": "0001",
    "creationDate": "2024-02-29T18:41:49.940+00:00",
    "errors": [],
    "status": {
        "code": "100",
        "description": "RECEIVED",
        "detail": "WIRE OUT"
    },
    "accountNumber": "032.032.00000016",
    "amount": 965.0,
    "fees": {
        "description": "Fee",
        "currency": "ARS",
        "amount": 35.0,
        "account": "032.032.00000016"
    },
    "localTaxes": [],
    "withHoldings": [],
    "comment": "WireOut_External"
}

400: Bad Request

{
    "status": {
        "code": "300",
        "description": "REJECTED",
        "detail": "[to.address must not be empty]"
    },
    "timestamp": "2024-02-29 18:52:05.640378596",
    "errors": [
        {
            "code": "300",
            "detail": "to.address must not be empty"
        }
    ]
}

Example Wire Out request

Request

{
    "to": {
        "name": "BBVA Arg.",
        "swift": "BCSARG",
        "address": "YourAccountNumber",
        "accountName": "YourAccountName",
        "accountNumber": "YourAccountNumber",
        "routingNumber": "routingNumber",
        "beneficiaryAddress": "beneficiaryAddress"
    },
    "amount": 1000,
    "comment": "WireOut_External",
    "country": "ARG",
    "currency": "ARS",
    "externalId": "{{externalId}}",
    "accountNumber": "032.032.00000016",
    "transactionType": "WireOut"
}

Status Ok

{
    "transactionType": "WireOut",
    "externalId": "",
    "internalId": "c0e5ec40-b5b6-49aa-8c2d-b1ba01080100",
    "country": "ARG",
    "currency": "ARS",
    "clientCode": "0001",
    "creationDate": "2024-02-29T18:41:49.940+00:00",
    "errors": [],
    "status": {
        "code": "100",
        "description": "RECEIVED",
        "detail": "WIRE OUT"
    },
    "accountNumber": "032.032.00000016",
    "amount": 965.0,
    "fees": {
        "description": "Fee",
        "currency": "ARS",
        "amount": 35.0,
        "account": "032.032.00000016"
    },
    "localTaxes": [],
    "withHoldings": [],
    "comment": "WireOut_External"
}

Bad Request

{
    "externalId": "",
    "internalId": "1ed699ea-9feb-4122-a304-cc1f830204a6",
    "errors": [
        {
            "code": "721",
            "detail": "NotAllowedCurrency"
        }
    ],
    "status": {
        "code": "721",
        "description": "REJECTED",
        "detail": "NotAllowedCurrency"
    }
}

Wire Out instruction by V3 Front

Next, review the guide to generate a Wire Out instruction in dashboard of V3