Market specifications

Do you want to know more information about Paraguay's market? Go to the Paraguay’s economy and eCommerce market article.

Country reference

`country` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.document.id` format
`PY`	`PYG`	2	CI	Between 5 to 20 digits

Document validations

Validation	Name	Length	Type	Verification digit
Document	CI	7	numeric	N/A
Document	RUC	8	numeric	CI + validation algorithm

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B	P2P
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`beneficiary.document.id`	Yes	Yes	Yes
`beneficiary.document.type`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	Yes	Yes
`beneficiary.last_name`	Yes	Yes	Yes
`beneficiary.bank_account.code`	Yes	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.document.id`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes

Payment methods

Paraguay supports payouts via Bank transfers. This method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Bank transfers

Bank transfers in Paraguay require detailed account information, including document type, document ID, bank account, bank code, currency, and amount. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the document validations, bank account validations and bank codes sections for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), `P2P` (Person to Person) or `PSP` (Payment Service Provider).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For Paraguay, use `PY`.
`currency`	Source currency of the FX operation. For Paraguay, use `PYG` or `USD`. Payouts are always paid in local currency to the beneficiary, unless specified otherwise at `currency_to_pay`.
`currency_to_pay`	Currency in which the payout should be paid. For Paraguay, use `PYG` or `USD`.
`amount`	Payout amount. Use up to 2 decimal places.
`beneficiary.document.id`	Document ID of the beneficiary. See document validations section.
`beneficiary.document.type`	Document type: `CI`, `RUC`. See document validations section.
`beneficiary.first_name`	First name of the beneficiary. Maximum 50 characters.
`beneficiary.last_name`	Last name of the beneficiary. Maximum 50 characters.
`beneficiary.bank_account.code`	Bank code of the beneficiary's bank. See bank codes section.
`beneficiary.bank_account.account`	Bank account number. See bank account validations section.
`currency_to_pay`	Currency to be paid out. `USD`. Mandatory only if the payout needs to be paid in USD. In case this parameter is missing, the payout will be paid in local currency.
`remitter.first_name`	First name of the remitter. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Last name of the remitter. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.address.street`	Street address of the remitter. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	City of the remitter. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	ISO 3166-1 alpha-2 code of the remitter. Length: 2 characters. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "BT_B2C_001",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "PY",
  "currency": "PYG",
  "amount": 245.40,
  "beneficiary": {
    "first_name": "Juan",
    "last_name": "PEREZ",
    "document": {
      "id": "1234567",
      "type": "CI"
    },
    "bank_account": {
      "code": "11",
      "account": "1234567891234567"
    }
  },
  "comments": "this is the 1st comment",
  "notification_url": "https://thisisawebsite.net/payments"
}

{
  "external_id": "BT_P2P_001",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "PY",
  "currency": "PYG",
  "amount": 245.40,
  "beneficiary": {
    "first_name": "Juan",
    "last_name": "PEREZ",
    "document": {
      "id": "1234567",
      "type": "CI"
    },
    "bank_account": {
      "code": "11",
      "account": "1234567891234567"
    }
  },
  "remitter": {
    "first_name": "MARIA",
    "last_name": "LOPEZ",
    "document": {
      "id": "ABC123456"
    },
    "address": {
      "street": "123 Main St",
      "city": "Miami",
      "country": "US"
    }
  },
  "notification_url": "https://thisisawebsite.net/payments"
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Paraguay.

Bank account validations

Validation	Name	Length	Type	Verification digit
Bank account	SIPAP	16	numeric	N/A

Bank codes

These are the values the beneficiary.bank_account.code parameter can take in Paraguay for accounts in local currency (PYG) as well as USD.

Bank Name	Bank Code
Banco Amambay S.A.	1
Banco Atlas S.A.	2
Banco BASA S.A.	3
Banco Busaif S.A. de Inversion y Fomento	5
Banco Central del Paraguay	6
Banco Comercial Paraguayo S.A.	7
Banco Continental S.A.E.C.A.	8
Banco Corporacion S.A.	9
Banco de Desarrollo del Paraguay S.A.	10
Banco de Inversiones del Paraguay	11
Banco de La Nacion Argentina	12
Banco Do Brasil S.A.	13
Banco Familiar S.A.E.C.A.	14
Banco Finamerica S.A.E.C.A.	15
Banco General S.A.	16
Banco GNB Paraguay S.A.	17
Banco Itapua S.A.E.C.A.	18
Banco Itau Paraguay S.A.	19
Banco Nacional de Fomento	20
Banco Nacional de Trabajadores	21
Banco Para la Comercializacion Y La Produccion S.A (BANCOP S.A.)	22
Banco Paraguayo Oriental de Inversion y Fomento S.A.	23
Banco Regional S.A.E.C.A.	24
Banco Rio S.A.E.C.A.	25
BOLPAR Sociedad Anonima	26
British American Tobacco Productora de Cigarrillos S.A.	28
Citibank N.A.	29
Crisol y Encarnacion Financiera S.A.	30
Financiera Exportadora Paraguaya S.A.	32
Financiera Paraguayo Japonesa S.A.E.C.A.	33
Finlantina S.A. de Finanzas	40
Fonplata - Fondo Financiero Para El Desarollo de La Cuenca Del Plata	34
GNB Fusion	4
Grupo Internacional de Finanzas S.A. C.A. (Interfisa Financiera)	35
Sudameris Bank S.A.E.C.A.	37
Summa Asesories	38
Tu Financiera	42
Ueno Bank S.A.	48