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 e Instrumentos financeiros, ou use o Utilitário de schema de payload.

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 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 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 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.