Payin Virtual Account
Example callback for creating a virtual account and receiving payments
Once the creation of a Virtual Account is requested, you will receive notifications of the status of the request. To know the notification format, see the Completed or InProgress tabs.
Completed
InProgress
On receiving a payment
{
"transactionType": "VirtualAccount",
"data": {
"externalId": "XXXXX",
"internalId": "XXXXX",
"accountNumber": "XXXXX",
"country": "ARG",
"currency": "ARS",
"beneficiary": {
"type": "INDIVIDUAL",
"name": "Juan",
"lastname": "Perez",
"document": {
"type": "XXXXX",
"id": "XXXXX"
},
"bank": {
"account": {
"number": "XXXXX"
}
}
},
"status": {
"code": "200",
"description": "COMPLETED",
"detail": "Virtual account has been created"
},
"errors": []
}
}
{
"transactionType": "VirtualAccount",
"data": {
"externalId": "XXXXX",
"internalId": "XXXXX",
"accountNumber": "XXXXX",
"country": "ARG",
"currency": "ARS",
"beneficiary": {
"type": "INDIVIDUAL",
"name": "Juan",
"lastname": "Perez",
"document": {
"type": "XXXXX",
"id": "XXXXX"
},
"bank": {
"account": {
"number": "XXXXX"
}
}
},
"status": {
"code": "100",
"description": "INPROGRESS",
"detail": "Virtual account in progress"
},
"errors": []
}
}
{
"transactionType": "PayIn",
"transactionFlow": null,
"data": {
"transactionType": "PayIn",
"externalId": "xxxx",
"internalId": "xxxx",
"paymentMethod": {
"type": "BankTransfer",
"code": "1025",
"flow": "DIRECT"
},
"country": "ARG",
"currency": "ARS",
"amount": 12,
"accountNumber": "xxxx",
"confirmed": {
"currency": "ARS",
"fxQuote": 1,
"amount": 12
},
"payment": {
"currency": "ARS",
"fxQuote": 1,
"financingFee": 0,
"amount": 12
},
"localTaxes": [],
"withHoldings": [],
"fees": {
"description": "Fee",
"currency": "ARS",
"fxSource": 189.115298,
"fxQuote": 1,
"amount": 10,
"account": "xxxx"
},
"status": {
"code": "200",
"description": "COMPLETED",
"detail": "The payin was credited"
},
"beneficiary": {
"type": "INDIVIDUAL",
"name": "FirstName",
"lastname": "Lastname",
"document": {
"type": "xxxx",
"id": "xxxx"
}
},
"merchant": {
"type": "COMPANY",
"name": "Localpayment Test"
},
"payer": {
"type": "COMPANY",
"name": "PayerName",
"document": {
"type": "xxxx",
"id": "xxxx"
},
"email": "[email protected]",
"bank": {
"name": "xxxx",
"code": "000",
"branch": {
"code": "0003"
},
"account": {
"type": "C",
"number": "xxxx"
}
}
},
"wireInstructions": {
"beneficiary": {
"name": "TEST SRL",
"document": {
"type": "CUIT",
"id": "30123456789"
},
"bank": {
"name": "ITAU Argentina",
"code": "259",
"branch": {
"code": ""
},
"account": {
"type": "C",
"number": "2590005910371048123456"
}
}
},
"referenceCode": "1025006555"
},
"date": {
"creationDate": "2023-02-07T12:14:14Z",
"processedDate": "2023-02-07T12:14:14Z"
},
"errors": []
}
}
Once the Virtual Account creation is complete, users will be able to receive payments through the local ACH network. Localpayment will send notifications for each Payin received to the URL configured as Callback. You can check the notification format in the "On receiving a payment" tab:
Receiving a payment (Payin)
{
"transactionType": "PayIn",
"transactionFlow": null,
"data": {
"transactionType": "PayIn",
"externalId": "xxxx",
"internalId": "xxxx",
"paymentMethod": {
"type": "BankTransfer",
"code": "1025",
"flow": "DIRECT"
},
"country": "ARG",
"currency": "ARS",
"amount": 12,
"accountNumber": "xxxx",
"confirmed": {
"currency": "ARS",
"fxQuote": 1,
"amount": 12
},
"payment": {
"currency": "ARS",
"fxQuote": 1,
"financingFee": 0,
"amount": 12
},
"localTaxes": [],
"withHoldings": [],
"fees": {
"description": "Fee",
"currency": "ARS",
"fxSource": 189.115298,
"fxQuote": 1,
"amount": 10,
"account": "xxxx"
},
"status": {
"code": "200",
"description": "COMPLETED",
"detail": "The payin was credited"
},
"beneficiary": {
"type": "INDIVIDUAL",
"name": "FirstName",
"lastname": "Lastname",
"document": {
"type": "xxxx",
"id": "xxxx"
}
},
"merchant": {
"type": "COMPANY",
"name": "Localpayment Test"
},
"payer": {
"type": "COMPANY",
"name": "PayerName",
"document": {
"type": "xxxx",
"id": "xxxx"
},
"email": "[email protected]",
"bank": {
"name": "xxxx",
"code": "000",
"branch": {
"code": "0003"
},
"account": {
"type": "C",
"number": "xxxx"
}
}
},
"wireInstructions": {
"beneficiary": {
"name": "TEST SRL",
"document": {
"type": "CUIT",
"id": "30123456789"
},
"bank": {
"name": "ITAU Argentina",
"code": "259",
"branch": {
"code": ""
},
"account": {
"type": "C",
"number": "2590005910371048123456"
}
}
},
"referenceCode": "1025006555"
},
"date": {
"creationDate": "2023-02-07T12:14:14Z",
"processedDate": "2023-02-07T12:14:14Z"
},
"errors": []
}
}
Last modified 1mo ago