# Requisitos de Dados do México (MXN)

Esta página lista todos os requisitos de dados para pagamentos em MXN para o México: as identidades
do beneficiário e do ordenante, o instrumento financeiro do beneficiário e a própria transação.

Os campos exibidos são os exigidos por este corredor
As tabelas de identidade e instrumento financeiro nesta página listam apenas os campos que o `MX_SPEI`
exige, extraídos do schema PII v3. Identidades e instrumentos financeiros aceitam outros campos
opcionais. Para o conjunto completo, consulte
[Identidades do pagamento](/pt-br/products/payments-direct-2/introduction/concepts/payment-identities) e
[Instrumentos financeiros](/pt-br/products/payments-direct-2/introduction/concepts/financial-instruments), ou use o
[Utilitário de schema de payload](/pt-br/products/payments-direct-2/api-docs/integration-resources/payload-schema-utility).

## Identidade do beneficiário

Crie a identidade do beneficiário antes do instrumento financeiro e faça referência a ela ao
criar o pagamento. Consulte [Criar e gerenciar identidades](/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-identities)
para o fluxo da API.

Os campos obrigatórios dependem de o beneficiário ser uma **empresa** ou uma **pessoa física**.

### Beneficiário empresa

Aplica-se aos casos de uso **B2B**, **B2B2B** e **C2B2B**. Envie uma identidade `business`.

| Campo  | Obrigatório | Tipo | Restrições  |
|  --- | --- | --- | --- |
| `businessName` | Obrigatório | STRING | Razão social. De 1 a 140 caracteres. Deve corresponder a `^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$`. |
| `address.streetAddress` | Obrigatório | ARRAY de STRING | Permite armazenar o endereço da empresa. |
| `address.country` | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a `^[A-Z]+$`. |
| `address.city` | Obrigatório | STRING | Cidade. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$`. |
| `address.stateOrProvince` | Obrigatório | STRING | Estado, província ou condado do endereço da empresa, conforme definido pelos serviços postais. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$`. |
| `address.postalCode` | Obrigatório | STRING | Código postal da empresa. De 3 a 15 caracteres. Deve corresponder a `^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$`. |


### Beneficiário pessoa física

Aplica-se aos casos de uso **B2B2C**, **B2C** e **C2B2C**. Envie uma identidade `individual`.

| Campo  | Obrigatório | Tipo | Restrições  |
|  --- | --- | --- | --- |
| `firstName` | Obrigatório | STRING | Nome da pessoa física. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$`. |
| `lastName` | Obrigatório | STRING | Sobrenome da pessoa física. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$`. |
| `address.streetAddress` | Obrigatório | ARRAY de STRING | Permite armazenar o endereço da pessoa física. |
| `address.country` | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a `^[A-Z]+$`. |
| `address.city` | Obrigatório | STRING | Cidade. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$`. |
| `address.stateOrProvince` | Obrigatório | STRING | Estado, província ou condado do endereço da pessoa física, conforme definido pelos serviços postais. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$`. |
| `address.postalCode` | Obrigatório | STRING | Código postal do endereço da pessoa física. De 3 a 15 caracteres. Deve corresponder a `^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$`. |


## Instrumento financeiro do beneficiário

Defina `financialInstrumentType: MX_SPEI` e `currency: MXN`. Forneça os campos a seguir no objeto payment rail `mxSpei`. Consulte [Criar e gerenciar instrumentos financeiros](/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-financial-instruments) para conhecer o fluxo da API.

O roteamento é feito inteiramente pela CLABE de 18 dígitos, que identifica o banco, a agência e a conta de destino. Nenhum código de banco ou de agência separado é necessário.

| Campo  | Obrigatório | Tipo | Restrições  |
|  --- | --- | --- | --- |
| `bankName` | Obrigatório | STRING | O nome do banco da identidade. De 2 a 140 caracteres. Deve corresponder a `^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$`. |
| `clabe` | Obrigatório | STRING | O código de identificação da conta CLABE da identidade. Exatamente 18 caracteres. Deve corresponder a `^\d+$`. |


## Identidade do ordenante

Crie a identidade do ordenante uma vez e reutilize-a em todos os pagamentos.

Os campos obrigatórios dependem de o ordenante ser uma **empresa** ou uma **pessoa física**.

### Ordenante empresa

Aplica-se aos casos de uso **B2B**, **B2B2B**, **B2B2C** e **B2C**. Envie uma identidade `business`.

| Campo  | Obrigatório | Tipo | Restrições  |
|  --- | --- | --- | --- |
| `businessName` | Obrigatório | STRING | Razão social. De 1 a 140 caracteres. Deve corresponder a `^(?![ .,'&\/()-])(?!.*([ .,'&\/()-])\1)[\p{L}\p{N} .,'&\/()-]+(?<![ .,'&\/-])?$`. |
| `address.streetAddress` | Obrigatório | ARRAY de STRING | Permite armazenar o endereço da empresa. |
| `address.country` | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a `^[A-Z]+$`. |
| `address.city` | Obrigatório | STRING | Cidade. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$`. |
| `address.stateOrProvince` | Obrigatório | STRING | Estado, província ou condado do endereço da empresa, conforme definido pelos serviços postais. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$`. |
| `address.postalCode` | Obrigatório | STRING | Código postal da empresa. De 3 a 15 caracteres. Deve corresponder a `^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$`. |


### Ordenante pessoa física

Aplica-se aos casos de uso **C2B2B** e **C2B2C**. Envie uma identidade `individual`.

| Campo  | Obrigatório | Tipo | Restrições  |
|  --- | --- | --- | --- |
| `firstName` | Obrigatório | STRING | Nome da pessoa física. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$`. |
| `lastName` | Obrigatório | STRING | Sobrenome da pessoa física. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*([ .'-])\1)[\p{L} .'-]+(?<![ .'-])$`. |
| `address.streetAddress` | Obrigatório | ARRAY de STRING | Permite armazenar o endereço da pessoa física. |
| `address.country` | Obrigatório | STRING | Exatamente 2 caracteres. Deve corresponder a `^[A-Z]+$`. |
| `address.city` | Obrigatório | STRING | Cidade. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*[ .'-]{2})[\p{L} .'-]+(?<![ .'-])$`. |
| `address.stateOrProvince` | Obrigatório | STRING | Estado, província ou condado do endereço da pessoa física, conforme definido pelos serviços postais. De 1 a 140 caracteres. Deve corresponder a `^(?![ .'-])(?!.*[ .'-]{2})[\p{L}\p{N} .'-]+(?<![ .'-])$`. |
| `address.postalCode` | Obrigatório | STRING | Código postal do endereço da pessoa física. De 3 a 15 caracteres. Deve corresponder a `^[\p{L}\p{N}][\p{L}\p{N} -]{1,15}[\p{L}\p{N}]$`. |


## Requisitos de dados de transação

Os dados do beneficiário e do ordenante vêm das identidades que você cria previamente, e os dados bancários vêm do instrumento financeiro. O único campo que você define no próprio pagamento para este corredor está abaixo.

| Campo  | Descrição | Obrigatório | Tipo | Restrições  |
|  --- | --- | --- | --- | --- |
| `paymentMemo` | Memo do pagamento | Opcional | STRING | De 1 a 140 caracteres. Apenas letras, dígitos e espaços. Somente os primeiros 40 caracteres são entregues. Consulte [Memo constraints](#restri%C3%A7%C3%B5es-de-memo) abaixo. |


### Restrições de memo

Apenas 40 caracteres do memo são entregues ao beneficiário. Você pode enviar até 140, e um memo com mais de 40 caracteres é encurtado para os primeiros 40 antes de o pagamento ser enviado.

Memos com mais de 40 caracteres são encurtados sem aviso
Nenhum erro é retornado quando um memo é encurtado, e o pagamento é concluído. O beneficiário vê
apenas os primeiros 40 caracteres no registro SPEI, portanto coloque a parte que o beneficiário precisa para
a conciliação, como um número de fatura, no início do memo.

Caracteres fora de letras, dígitos e espaços são rejeitados em vez de removidos, e o pagamento falha. Mantenha pontuação como hifens e barras fora do memo.