How to Create a PYG Transfer

PYG transfers send funds to a Paraguayan bank account. Bank accounts for LATAM are not associated with beneficiaries — they are created automatically when the transfer is submitted.

There are three ways to create a PYG transfer:

• Option A — New transfer using an account alias (creates the bank account inline)
• Option B — New transfer with full bank data (creates the bank account inline)
• Option C — Reuse a previously created bank account via bankAccountId

PDF attachments are optional for PYG transfers. If included: maximum 10 files, maximum 1 MB per file, PDF format only.

---

Option A — Alias

Pass the account alias as accountNumber and the account holder name as bankAccountName. No additional bank fields are required.

Required fields for this option:

Field	Description
currency	PYG
amount	Amount in PYG
bankCountry	Country code (PY)
accountNumber	Account alias
bankAccountName	Account holder name

Request

curl -X POST "/api/v1/transfer" \
  -H "Authorization: Bearer <token>" \
  -F "currency=PYG" \
  -F "amount=7000000" \
  -F "bankCountry=PY" \
  -F "accountNumber=0981123456" \
  -F "bankAccountName=Carlos Martínez"

---

Option B — Full Bank Data

Pass complete bank account data. taxId contains the Cédula de identidad of the account holder and is required when bankName is provided.

Required fields for this option:

Field	Description
currency	PYG
amount	Amount in PYG
amountInUSD	Equivalent amount in USD
quote	Exchange rate (USD → PYG)
bankCountry	PY
accountNumber	Bank account number
bankAccountName	Account holder name
bankName	Bank name
taxId	Cédula de identidad

Request

curl -X POST "/api/v1/transfer" \
  -H "Authorization: Bearer <token>" \
  -F "currency=PYG" \
  -F "amount=7000000" \
  -F "bankCountry=PY" \
  -F "accountNumber=0011234567" \
  -F "bankAccountName=Carlos Martínez" \
  -F "bankName=Banco Continental" \
  -F "taxId=4567890"

---

Option C — Existing Bank Account

If a bank account was previously created through a prior transfer, it can be reused by passing its id as bankAccountId. No bank account fields are needed.

List existing Paraguayan bank accounts

curl -X GET "/api/v1/bank-account?bankCountry=PY" \
  -H "Authorization: Bearer <token>"

This returns a paginated list of bank accounts linked to the authenticated user. Use the id of the desired account.

Request

curl -X POST "/api/v1/transfer" \
  -H "Authorization: Bearer <token>" \
  -F "bankAccountId=d6c6c357-343f-4106-8f7d-b678c60ff10a" \
  -F "currency=PYG" \
  -F "amount=7000000" \

---

Response (201) — All options

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "transferNumber": "002095696342671878",
  "status": "pending",
  "currency": "PYG",
  "amount": "6400000",
  "amountInUSD": "1000.00",
  "quote": "6400.00",
  "pdfDocuments": [],
  "bankAccount": {
    "id": "d6c6c357-343f-4106-8f7d-b678c60ff10a",
    "name": "Carlos Martínez",
    "bankCountry": "PY",
    "accountNumber": "0011234567",
    "bankName": "Banco Continental",
    "taxId": "4567890"
  },
  "createdAt": "2026-05-14T12:05:00.000Z",
  "updatedAt": "2026-05-14T12:05:00.000Z"
}

---

Balance Impact

Event	Effect on Balance
Transfer created	amountInUSD is immediately deducted from the user's available balance
Transfer rejected	Amount is automatically restored to the user's balance