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.

Completed

{
  "transactionType": "VirtualAccount",
  "data": {
    "externalId": "XXXXX",
    "internalId": "XXXXX",
    "accountNumber": "XXXXX",
    "country": "ARG",
    "currency": "ARS",
    "beneficiary": {
      "type": "INDIVIDUAL",
      "name": "Beneficiary Name",
      "lastname": "Beneficiary Lastname",
      "document": {
        "type": "XXXXX",
        "id": "XXXXX"
      },
      "bank": {
        "account": {
          "number": "0000472900016847756532"
        }
      }
    },
    "status": {
      "code": "200",
      "description": "COMPLETED",
      "detail": "Virtual account has been created"
    },
    "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",
      "externalId":  "{{externalId}}",
      "internalId": "{{internalId}}",
      "paymentMethod": {
        "type": "BankTransfer",
        "code": "1630",
        "flow": "DIRECT"
      },
      "country": "MEX",
      "currency": "MXN",
      "amount": 1000,
      "accountNumber": "{{YourAccountNumber}}",
      "confirmed": {
        "currency": "MXN",
        "fxQuote": 1,
        "amount": 1000
      },
      "payment": {
        "currency": "MXN",
        "fxQuote": 1,
        "financingFee": 0,
        "amount": 1000
      },
      "localTaxes": [],
      "withHoldings": [],
      "fees": {
        "description": "Fee",
        "currency": "MXN",
        "fxSource": 1,
        "fxQuote": 1,
        "amount": 50,
        "account": "{{YourAccountNumber}}"
      },
      "status": {
        "code": "200",
        "description": "COMPLETED",
        "detail": "The payin was credited"
      },
      "beneficiary": {
        "type": "INDIVIDUAL",
        "name": "Pedro",
        "lastName": "Perez",
        "document": {
          "type": "RFC",
          "id": "LEKF8111118Z5"
        },
        "bank": {
          "account": {
            "number": "646011319800015054"
          }
        },
        "informedName": "LPV3_PayinVA"
      },
      "merchant": {
        "type": "COMPANY",
        "name": "MerchantName"
      },
      "payer": {
        "type": "INDIVIDUAL",
        "name": "STP",
        "lastName": "STP",
        "document": {
          "type": "ND",
          "id": "ND"
        },
        "email": "NA",
        "bank": {
          "name": "Sistema de Transferencias y Pagos",
          "code": "646",
          "branch": {},
          "account": {
            "type": "C",
            "number": "646010319800001674"
          }
        }
      },
      "date": {
        "creationDate": "2024-02-19T20:18:30.373",
        "processedDate": "2024-02-19T20:18:30.601"
      },
      "errors": [],
      "referenceCode": "C2VV-MVVN-QHFI",
      "tracking": {
        "id": "lpv3_1111-19feb2024-2400",
        "reference": "999999",
        "concept": "concepto pago LPV3_4707"
      }
    }