# Peru (PEN) Data Requirements

This page lists every data requirement for PEN payments to Peru: the beneficiary and
originator identities, the beneficiary financial instrument, and the transaction itself.

Fields shown are those required for this corridor
The identity and financial instrument tables on this page list only the fields `PE_LBTR`
requires, taken from the PII v3 schema. Identities and financial instruments accept further
optional fields. For the complete set, see
[Payment identities](/products/payments-direct-2/introduction/concepts/payment-identities) and
[Financial instruments](/products/payments-direct-2/introduction/concepts/financial-instruments), or use the
[Payload Schema Utility](/products/payments-direct-2/api-docs/integration-resources/payload-schema-utility).

## Beneficiary identity

Create the beneficiary identity before the financial instrument, then reference it when you
create the payment. See [Create and manage identities](/products/payments-direct-2/api-docs/developer-guides/create-and-manage-identities)
for the API workflow.

The required fields depend on whether the beneficiary is a **business** or an **individual**.

### Business beneficiary

Applies to the **B2B**, **B2B2B**, **C2B2B** use cases. Submit a `business` identity.

| Field  | Required | Type | Constraints  |
|  --- | --- | --- | --- |
| `businessName` | Required | STRING | Business Legal Name. 1–140 characters. Must match `^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$`. |
| `address.streetAddress` | Required | ARRAY of STRING | Allows the street address of the business to be held. |
| `address.country` | Required | STRING | Exactly 2 characters. Must match `^[A-Z]+$`. |
| `address.city` | Required | STRING | City. 1–140 characters. Must match `^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$`. |
| `address.stateOrProvince` | Required | STRING | State, province, or county of the business address, as defined by postal services. 1–140 characters. Must match `^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$`. |
| `address.postalCode` | Required | STRING | Postal code for the business. 3–15 characters. Must match `^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$`. |
| `email` | Required | STRING | Address for electronic mail (e-mail). 6–255 characters. Format `email`. Must match `^(?=.{1,254}$)(?:[\p{L}\p{N}%+_-]+(?:\.[\p{L}\p{N}%+_-]+)*)@(?:(?:[\p{L}\p{N}](?:[\p{L}\p{N}-]{0,61}[\p{L}\p{N}])?)\.)+[\p{L}]{2,63}$`. |
| `phone` | Required | STRING | Phone Number. 8–16 characters. Must match `^\+[1-9]\d+$`. |
| `registration[].number` | Required | STRING | The unique identifier of the organization. 3–35 characters. Must match `^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$`. |
| `registration[].type` | Required | STRING | Must be `TAX_ID`. |
| `incorporationCountry` | Required | STRING | Exactly 2 characters. Must match `^[A-Z]+$`. |


### Individual beneficiary

Applies to the **B2B2C**, **B2C**, **C2B2C** use cases. Submit an `individual` identity.

| Field  | Required | Type | Constraints  |
|  --- | --- | --- | --- |
| `firstName` | Required | STRING | First name of the individual. 1–140 characters. Must match `^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$`. |
| `lastName` | Required | STRING | Last name of the individual. 1–140 characters. Must match `^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$`. |
| `address.streetAddress` | Required | ARRAY of STRING | Allows the street address of the individual to be held. |
| `address.country` | Required | STRING | Exactly 2 characters. Must match `^[A-Z]+$`. |
| `address.city` | Required | STRING | City. 1–140 characters. Must match `^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$`. |
| `address.stateOrProvince` | Required | STRING | State, province, or county of the individual's address, as defined by postal services. 1–140 characters. Must match `^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$`. |
| `address.postalCode` | Required | STRING | Postal code for the individual's address. 3–15 characters. Must match `^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$`. |
| `email` | Required | STRING | Address for electronic mail (e-mail). 6–255 characters. Format `email`. Must match `^(?=.{1,254}$)(?:[\p{L}\p{N}%+_-]+(?:\.[\p{L}\p{N}%+_-]+)*)@(?:(?:[\p{L}\p{N}](?:[\p{L}\p{N}-]{0,61}[\p{L}\p{N}])?)\.)+[\p{L}]{2,63}$`. |
| `phone` | Required | STRING | Phone Number. 8–16 characters. Must match `^\+[1-9]\d+$`. |
| `identityDocuments[].idNumber` | Required | STRING | Identification Number. 3–35 characters. Must match `^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$`. |
| `identityDocuments[].idType` | Required | STRING | One of `NATIONAL_ID_NUMBER`, `TAX_ID`. |
| `dateOfBirth` | Required | STRING | Date of Birth. Format `date`. |
| `citizenship` | Required | STRING | Alpha-2 country code for the nationality of the individual in ISO 3166-1 format. Exactly 2 characters. Must match `^[A-Z]+$`. |


## Beneficiary financial instrument

Set `financialInstrumentType: PE_LBTR` and `currency: PEN`. Provide the following fields in the `peLbtr` payment rail object. See [Create and manage financial instruments](/products/payments-direct-2/api-docs/developer-guides/create-and-manage-financial-instruments) for the API workflow.

| Field  | Required | Type | Constraints  |
|  --- | --- | --- | --- |
| `bankName` | Required | STRING | The name of the identity's bank. 2–140 characters. Must match `^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$`. |
| `swiftCode` | Required | STRING | SWIFT/BIC code of the identity's bank. 8–11 characters. Must match `^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$`. Use the [Bank Codes](/products/payments-direct-2/api-docs/integration-resources/ripple-bank-codes) lookup and select Peru to find the SWIFT/BIC code. |
| `accountNumber` | Required | STRING | The identity's bank account number. 10–20 characters. Must match `^[A-Za-z0-9]+$`. |
| `accountType` | Required | STRING | The identity's account type. One of `CHECKING`, `SAVINGS`. |


## Originator identity

Create the originator identity once and reuse it across payments.

The required fields depend on whether the originator is a **business** or an **individual**.

### Business originator

Applies to the **B2B**, **B2B2B**, **B2B2C**, **B2C** use cases. Submit a `business` identity.

| Field  | Required | Type | Constraints  |
|  --- | --- | --- | --- |
| `businessName` | Required | STRING | Business Legal Name. 1–140 characters. Must match `^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$`. |
| `address.streetAddress` | Required | ARRAY of STRING | Allows the street address of the business to be held. |
| `address.country` | Required | STRING | Exactly 2 characters. Must match `^[A-Z]+$`. |
| `address.city` | Required | STRING | City. 1–140 characters. Must match `^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$`. |
| `address.stateOrProvince` | Required | STRING | State, province, or county of the business address, as defined by postal services. 1–140 characters. Must match `^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$`. |
| `address.postalCode` | Required | STRING | Postal code for the business. 3–15 characters. Must match `^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$`. |
| `email` | Required | STRING | Address for electronic mail (e-mail). 6–255 characters. Format `email`. Must match `^(?=.{1,254}$)(?:[\p{L}\p{N}%+_-]+(?:\.[\p{L}\p{N}%+_-]+)*)@(?:(?:[\p{L}\p{N}](?:[\p{L}\p{N}-]{0,61}[\p{L}\p{N}])?)\.)+[\p{L}]{2,63}$`. |
| `phone` | Required | STRING | Phone Number. 8–16 characters. Must match `^\+[1-9]\d+$`. |
| `registration[].number` | Required | STRING | The unique identifier of the organization. 3–35 characters. Must match `^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$`. |
| `registration[].type` | Required | STRING | Must be `TAX_ID`. |
| `incorporationCountry` | Required | STRING | Exactly 2 characters. Must match `^[A-Z]+$`. |


### Individual originator

Applies to the **C2B2B**, **C2B2C** use cases. Submit an `individual` identity.

| Field  | Required | Type | Constraints  |
|  --- | --- | --- | --- |
| `firstName` | Required | STRING | First name of the individual. 1–140 characters. Must match `^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$`. |
| `lastName` | Required | STRING | Last name of the individual. 1–140 characters. Must match `^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$`. |
| `address.streetAddress` | Required | ARRAY of STRING | Allows the street address of the individual to be held. |
| `address.country` | Required | STRING | Exactly 2 characters. Must match `^[A-Z]+$`. |
| `address.city` | Required | STRING | City. 1–140 characters. Must match `^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$`. |
| `address.stateOrProvince` | Required | STRING | State, province, or county of the individual's address, as defined by postal services. 1–140 characters. Must match `^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$`. |
| `address.postalCode` | Required | STRING | Postal code for the individual's address. 3–15 characters. Must match `^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$`. |
| `email` | Required | STRING | Address for electronic mail (e-mail). 6–255 characters. Format `email`. Must match `^(?=.{1,254}$)(?:[\p{L}\p{N}%+_-]+(?:\.[\p{L}\p{N}%+_-]+)*)@(?:(?:[\p{L}\p{N}](?:[\p{L}\p{N}-]{0,61}[\p{L}\p{N}])?)\.)+[\p{L}]{2,63}$`. |
| `phone` | Required | STRING | Phone Number. 8–16 characters. Must match `^\+[1-9]\d+$`. |
| `identityDocuments[].idNumber` | Required | STRING | Identification Number. 3–35 characters. Must match `^(?![ .'-\/])(?!.*[ .'-\/]{2})([A-Za-z0-9 .'-\/]+)(?<![ .'-\/])\/?$`. |
| `identityDocuments[].idType` | Required | STRING | One of `PASSPORT`, `TAX_ID`. |
| `dateOfBirth` | Required | STRING | Date of Birth. Format `date`. |
| `countryOfBirth` | Required | STRING | Exactly 2 characters. Must match `^[A-Z]+$`. |
| `citizenship` | Required | STRING | Alpha-2 country code for the nationality of the individual in ISO 3166-1 format. Exactly 2 characters. Must match `^[A-Z]+$`. |


## Transaction data requirements

The beneficiary and originator details come from the identities you create beforehand, and the bank details from the financial instrument. The only field you set on the payment itself for this corridor is below.

| Field | Description | Required | Type | Constraints |
|  --- | --- | --- | --- | --- |
| `purposeCode` | Purpose of payment | Required | ENUM | Up to 4 characters. See [valid values](#purpose-of-payment-codes) below. |


## Purpose of payment codes

Send one of the following in `purposeCode`.

| Code | Description |
|  --- | --- |
| `COMP` | Compensation Payment |
| `FAMI` | Family Maintenance |
| `INVS` | Investment & Securities |
| `OTHR` | Others |
| `SUPP` | Supplier Payment |