Wire In
Learn how to fund your Localpayment account via Wire In transfers from external banks. Choose between API integration for automation or the Dashboard for manual processing.
Wire In
Overview
A Wire In is the process of transferring funds from an external financial institution's account to your Localpayment account. This transaction type increases your Localpayment account balance and is reflected in all account reports and statements.
Wire In transactions impact supplier account balances and provide complete transaction visibility through account statements and reporting dashboards.
You can process Wire In transactions through two methods:
- API Integration - For automated, programmatic transfers
- Localpayment Dashboard - For manual transactions through the web interface
How Wire In Works
The Wire In process follows a structured workflow to ensure secure and accurate fund transfers:
- Wire In Request - You initiate the transfer via API or Dashboard
- Pending Review - Transaction status changes to "Pending_Credit"
- Operations Validation - Our operations team reviews and validates the transaction details
- Processing - Once validated, the transaction proceeds to completion
- Completion - Status updates to "Completed" and funds are credited to your account
- Notification - You receive confirmation of successful transaction completion
Important: Wire In transactions automatically expire after 14 days if not completed.
Receipt Requirements
Upload your wire transfer receipt in one of these supported formats:
- PNG, JPG, JPEG (images)
- PDF (documents)
- TXT (text files)
Prerequisites
Before initiating a Wire In request, ensure you have:
- Wire transfer receipt - Proof of the external transfer
- Valid API credentials - With proper authorization permissions
- Complete transaction details - All required sender and recipient information
API Endpoint
To create a settlement, send a POST request to the Create Wire Inendpoint.
Endpoint
POST https://api.stage.localpayment.com/api/account/wire-inAuthentication
Include your access token in the Authorization header:
Authorization: Bearer <your_access_token>Key Request Parameters
The request requires several key parameters:
| Parameter | Type | Description | Required |
|---|---|---|---|
transactionType | string | Must be set to "WireIn" | ✅ |
currency | string | Currency code (e.g., "ARS", "USD") | ✅ |
country | string | Country code (e.g., "ARG", "USA") | ✅ |
amount | number | Transfer amount | ✅ |
accountNumber | string | Your Localpayment account number | ✅ |
to | object | Recipient bank details | ✅ |
from | object | Sender bank details | ✅ |
Example Request (Argentina)
curl --request POST \
--url https://api.stage.localpayment.com/api/account/wire-in \
--header 'Authorization: Bearer <your_access_token>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"transactionType": "WireIn",
"currency": "ARS",
"country": "ARG",
"amount": 50000,
"comment": "Monthly funding transfer",
"externalId": "258648ed-df89-422c-9eb0-e585014ed65e",
"accountNumber": "032.032.00000082",
"to": {
"name": "BANCO DE GALICIA Y BUENOS AIRES S.A.U.",
"swift": "GABAARBA",
"address": "Av. Hipólito Yrigoyen 155, X5000 Córdoba, Argentina",
"accountNumber": "0070119655111901676653",
"accountName": "Localpayment",
"beneficiaryAddress": "Av. Hipólito Yrigoyen 200, X5000 Córdoba, Argentina"
},
"from": {
"name": "BANCO DE LA NACION ARGENTINA",
"swift": "NACNARBA",
"address": "Av. Hipólito Yrigoyen 35, X5000 Córdoba, Argentina",
"accountNumber": "0110119655111901676653",
"routingNumber": null,
"accountName": "John Doe",
"beneficiaryAddress": "Av. Hipólito Yrigoyen 10, X5000 Córdoba, Argentina",
"intermediaryBankName": null,
"intermediaryBankSwift": null,
"intermediaryAccountNumer": null
}
}'Response Handling
Success Response
When your Wire In request is accepted, you'll receive a detailed response:
{
"transactionType": "WireIn",
"externalId": "258648ed-df89-422c-9eb0-e585014ed65e",
"internalId": "0f1d47dc-e9c6-4fdf-8ba1-c9b39116574d",
"country": "ARG",
"currency": "ARS",
"clientCode": "0001",
"creationDate": "2024-12-28T13:47:58.808+00:00",
"errors": [],
"status": {
"code": "100",
"description": "PENDING_CREDIT",
"detail": "WIRE IN"
},
"accountNumber": "032.032.00000082",
"amount": 49500,
"fees": {
"description": "Processing Fee",
"currency": "ARS",
"amount": 500,
"account": "032.032.00000082"
},
"localTaxes": [],
"withHoldings": [],
"comment": "Monthly funding transfer"
}Key Response Fields
| Field | Type | Description |
|---|---|---|
externalId | string | Your unique transaction identifier |
internalId | string | Localpayment's internal transaction ID |
creationDate | string | Transaction creation timestamp (ISO 8601) |
amount | number | Net amount after fees |
fees | object | Applied processing fees |
status | object | Current transaction status information |
Error Response
Validation Error Example
{
"externalId": "089c81c6-7be2-4798-8e53-d4bfff61f852",
"errors": [
{
"code": "404",
"detail": "This beneficiary account is invalid"
}
],
"status": {
"code": "404",
"description": "REJECTED",
"detail": "This beneficiary account is invalid"
}
}Track Transaction Status
After submitting a wire in, monitor its progress through these methods:
Webhooks (Recommended)
Receive real-time notifications when transaction status changes. Most efficient for production environments.
Status API Endpoint
Query transaction status programmatically. Useful for polling or recovering lost webhook notifications.
Dashboard View
Visual interface for monitoring transactions. Great for manual oversight and detailed transaction analysis.
Common Status Codes
| Code | Status | Description |
|---|---|---|
100 | PendingCredit | Pending Credit |
200 | Completed | Completed |
717 | RejectedByBank | Rejected |
Note: For complete status code reference, see the Transaction Status Documentation.
Security Recommendations
- Always use HTTPS for API requests
- Store access tokens securely (never in client-side code)
- Implement proper error handling and logging
- Validate all input data before sending requests
Next Steps
Webhook Integration
Set up real-time notifications for transaction status changes and automated processing
Transaction Monitoring
Learn how to track transaction status, lifecycle, and troubleshoot issues
Reporting & Analytics
Access comprehensive reports, reconciliation tools, and transaction history
Complete API Reference
Full API documentation with additional endpoints and advanced features
Support & Resources
Need assistance with your payout cancellation integration?
- Technical Support: Contact our support team for integration help
- API Documentation: Complete endpoint reference and guides
Pro Tip: Use our sandbox environment to test Wire In workflows and ensure your integration handles all scenarios correctly before going live.
Updated 5 days ago
