Incoming Wire In Notification

Notify Localpayment of an incoming wire transfer using our API to settle your account balance. This guide walks you through initiating a notification, handling API responses, and tracking the transaction.

For transactions in Fiat currency (e.g., USD, ARS, MXN), you are required to notify us of the incoming wire. This can be accomplished via:

• API Integration: Recommended for automated, programmatic notification.

• Localpayment Dashboard: Use the web interface for manual notification of individual transactions.

Important

The Wire In notification process is not used for Stablecoins. Instead, please follow the Stablecoin Wire In flow.

This guide covers the API workflow end to end, from notification to final settlement.

Wire In API

In your postman you must configure the request in Body-form-data.

Key: request; text

Value: paste the request

Key:filecontent;File

Value: Attach receipt (optional)

Example receipt

The file format can be in .png .jpg .jpeg .pdf or .txt

149KB

Example Receipt.jpg

image

Open

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

Headers

Name	Type	Description
Content-Type*	String	application/json
Authorization*	String	Mandatory. Bearer JWT token in format Bearer eyJ0... . For more information about authentication, please refer to Authentication
fileContent	String	Optional. Transfer receipt

Request Body

Name	Type	Description
transactiontype*	String	Mandatory. Add the transaction type:"WireIn
currency*	String	Mandatory. The currency in which the amount is expressed.
country*	String	Mandatory. ISO 3166-1 alpha-3.
amount*	String	Mandatory. Amount to charge to your end user
comment	String	Optional. A comment related to the transaction. It should be something meaningful to your business.
externalId*	String	Mandatory. An ID that is meaningful to you and your system. Must be unique.
accountNumber*	String	Mandatory. Your Localpayment account number in which the amount will be credited.
to*	Object	Beneficiary data
to.name*	String	Mandatory. Beneficiary name.
to.swift*	String	Mandatory. Bank identification code most used to make international money transfers.
to.address*	String	Mandatory. Bank´s Address
to.accountNumber*	String	Mandatory. Beneficiary account number
to.accountName*	String	Mandatory. Beneficiary owner name
to.beneficiaryAddress*	String	Mandatory. Address of the account holder
from*	Object	Mandatory. Details of the ordering bank
from.name*	String	Mandatory. It is the name of the ordering Bank.
from.swift*	String	Mandatory. Ordering bank identification code to make international money transfers.
from.address*	String	Mandatory. Address of the ordering bank,
from.accountNumber*	String	Mandatory. Account number of de holder of the ordering bank
from.routingNumber	String	Transaction identifier code, that is, to indicate the banking entities of origin and destination of the transfers in the United States
from.accountName*	String	Mandatory. Name of the holder of the ordering bank account
from.beneficiaryAddress*	String	Mandatory. Address of the account holder of the ordering bank
intermediaryAccountNumber	String	The name of the intermediary bank (if any).
intermediaryBankSwift	String	The SWIFT code of the intermediary bank (if any).
intermediaryBankName	String	The account number at the intermediary bank (if any).

Example API

Request

Request

curl --request POST \
  --url https://api.stage.localpayment.com/api/account/wire-in \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 123' \
  --header 'Content-Type: multipart/form-data' \
  --form 'request={\"transactionType\":\"WireIn\",\"currency\":\"BOB\",\"country\":\"BOL\",\"amount\":100,\"comment\":\"Comment\",\"externalId\":\"a11h7890-78ju-098j-hu78-124ftn8lo0io\",\"accountNumber\":\"068.068.00000183\",\"to\":{\"name\":\"Bankname\",\"swift\":\"BCBHDOSD\",\"address\":\"BankAddress\",\"accountNumber\":\"1310825187\",\"accountName\":\"BeneficiaryBankName\",\"beneficiaryAddress\":\"BeneficiaryAddress\"},\"from\":{\"name\":\"OrderingBankName\",\"swift\":\"BICAARBS\",\"address\":\"OrderingBankAddress\",\"accountNumber\":\"123456789\",\"routingNumber\":null,\"accountName\":\"accountName\",\"beneficiaryAddress\":\"BeneficiaryAddress\",\"intermediaryBankName\":null,\"intermediaryBankSwift\":null,\"intermediaryAccountNumer\":null}}' \
  --form [email protected]

Response

200 Ok

{
    "transactionType": "WireIn",
    "transactionFlow": "wireInAutomatic",
    "externalId": "a11h7890-78ju-098j-hu78-124ftn8lo0io",
    "internalId": "b97fe1cd-50d3-4ee2-8a6e-34ee6d7e4f4e",
    "country": "BOL",
    "currency": "BOB",
    "clientCode": "0001",
    "creationDate": "2025-12-04T21:07:41.689+00:00",
    "errors": [],
    "status": {
        "code": "101",
        "description": "PENDING_AUTH",
        "detail": "Pending Auth"
    },
    "accountNumber": "068.068.00000183",
    "amount": 97.32,
    "fees": {
        "description": "Fee",
        "currency": "BOB",
        "amount": 0.5,
        "account": "068.068.00000183"
    },
    "localTaxes": [
        {
            "code": "0016",
            "percentage": 2.18,
            "description": "FNA",
            "currency": "BOB",
            "fxSource": 6.911493,
            "fxQuote": 0.0,
            "amount": 2.18,
            "account": "068.068.00000183"
        }
    ],
    "withHoldings": [],
    "comment": "Comment",
    "code": "101"
}

401 Error

Wire In instruction via Dashboard

In the Localpayment Dashboard, you may also create Wire Ins. Dashboard-generated Wire Ins can be set up to be approved or not. Check the step-by-step article for further details.

Wire In

Create a Wire In