Create a Virtual Account

post

https://api.stage.localpayment.com/api/virtual-account

This endpoint allows you to create multiple virtual accounts to receive local ACH bank transfers. By assigning these accounts to specific merchants or end users, you can streamline the reconciliation process and improve transaction tracking.

Body Params

externalId

string

required

A unique identifier that you provide to label and track virtual accounts within your system. This ID will be the primary reference for all future operations on this account (e.g., checking status, disabling, deleting). To guarantee uniqueness and prevent collisions, we strongly recommend using a UUID4 format.

accountNumber

string

required

Localpayment account number.

country

string

enum

required

Country. ISO 3166-1 alpha-3.

Allowed:

beneficiary

object

required

The individual or entity that will receive the funds paid into this virtual account. The beneficiary is the final recipient of the money and is not necessarily the legal owner or holder of the virtual account itself.

Headers

Authorization

string

required

Bearer access token for authentication. This token is obtained from the Get Access Token or Refresh Access Token endpoints.

Responses

Language

Credentials

Bearer

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Created

400Bad Request.

401Unauthorized.

403Forbidden