Transaction Matching Mode

How it works

Your platform creates an order with an expected amount and customer DNI before the transfer arrives.
PayRetailers waits for a transfer matching that exact amount from the same DNI and automatically
approves it.

Your platform creates a transaction -> PayRetailers returns Alias + CVU
You display the Alias and amount to the customer
Customer transfers the exact amount from their bank
PayRetailers matches the transfer by DNI + amount -> APPROVED
Webhook sent to your platform
You credit the customer's account

📘
The transfer amount must be exact. A difference of even ARS 1 will result in no match and an automatic refund to the sender. Additionally, the user must be the same as the owner of the source account.

Create Transaction

POST https://api.gateway.payretailers.com/payments/v2/transactions

{
  "paymentMethodId": "c1d67e21-e74e-4f73-9999-55e029e6ac78",
  "amount": "1500000",
  "currency": "ARS",
  "description": "Account deposit",
  "trackingId": "ea81101a-2808-4b44-a3d5-7f2a6f5b601f",
  "notificationUrl": "https://payment-form.payretailers.com/notification",
  "returnUrl": "https://payment-form.payretailers.com/return",
  "cancelUrl": "https://payment-form.payretailers.com/cancel",
  "language": "ES",
  "expirationDate": "2026-04-14T23:59:59Z",
  "customer": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "country": "AR",
    "personalId": "99988877",
    "city": "Buenos Aires",
    "address": "Av. Corrientes 1234",
    "zip": "C1043AAB",
    "phone": "1155551234",
    "deviceId": null,
    "ip": "181.166.100.10"
  }
  }

Webhook

{
  "uid": "9d013186-5c62-78e2-9325-4c4b8493d460",
  "type": "virtual_account_payment",
  "status": "APPROVED",
  "message": "",
  "trackingId": "ea81101a-2808-4b44-a3d5-7f2a6f5b601f",
  "amount": 1500000,
  "currency": "ARS",
  "amountChanged": false,
  "originalAmount": 0,
  "newCouponAmount": null,
  "newCouponCurrency": null,
  "description": "Account deposit",
  "cardNumber": null,
  "createdAt": "2026-04-13T09:34:36.83",
  "updatedAt": "2026-04-13T09:34:36.83",
  "customer": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "country": "AR",
    "city": "Buenos Aires",
    "zip": "C1043AAB",
    "address": "Av. Corrientes 1234",
    "phone": "1155551234",
    "deviceId": null,
    "ip": "181.166.100.10",
    "personalId": "99988877"
  },
  "billing": {
    "currency": "ARS",
    "amount": 1500000
  },
  "paymentMethod": {
    "id": "307f001e-daf9-4394-8dd1-a1e3e6b3070a",
    "name": "ALIAS",
    "type": null
  }

"payer": {
  "payerName": "John Doe",
  "name": "John Doe",
  "lastName": null,
  "personalId": "27999888776",
  "payoutAccountTypeCode": null,
  "accountused": "2850123410000000555666",
  "accountNumber": "2850123410000000555666",
  "accountAgencyNumber": null,
  "bankTrackingID": null,
  "bankName": null,
  "maskCardNumber": null
}
}

{
  "uid": "7c024a91-3b11-42e8-a712-9d3f1b2c8e45",
  "type": "virtual_account_payment",
  "status": "CANCELLED",
  "message": "NO_MATCHED_TRANSACTION",
  "trackingId": "ea81101a-2808-4b44-a3d5-7f2a6f5b601f",
  "amount": 1500000,
  "currency": "ARS",
  "amountChanged": false,
  "originalAmount": 0,
  "newCouponAmount": null,
  "newCouponCurrency": null,
  "description": "Account deposit",
  "cardNumber": null,
  "createdAt": "2026-04-13T10:15:22.00",
  "updatedAt": "2026-04-13T10:15:22.00",
  "customer": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "country": "AR",
    "city": "Buenos Aires",
    "zip": "C1043AAB",
    "address": "Av. Corrientes 1234",
    "phone": "1155551234",
    "deviceId": null,
    "ip": "181.166.100.10",
    "personalId": "99988877"
  },
  "billing": {
    "currency": "ARS",
    "amount": 1500000
  },
  "paymentMethod": {
    "id": "307f001e-daf9-4394-8dd1-a1e3e6b3070a",
    "name": "ALIAS",
    "type": null
  }
}

Value	Cause	What to show the customer
NO_MATCHED_TRANSACTION	Amount or payer DNI did not match any active order	"Your transfer could not be applied. Your funds will be returned automatically. Please create a new deposit with the exact amount."
CORPORATE_BANK_ACCOUNT_PAYMENT_NOT_ALLOWED	Transfer sent from a corporate bank account	"Only personal bank accounts are supported. Please transfer from your personal account."