Requisitos de Dados da Nigéria (NGN)

Esta página lista todos os requisitos de dados para pagamentos em NGN para a Nigéria: 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 de instrumento financeiro nesta página listam apenas os campos que NG_BANK_PAYOUT 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} .'-]+(?<![ .'-])$`.
`phone`	Obrigatório	STRING	Número de telefone. De 8 a 16 caracteres. Deve corresponder a `^\+[1-9]\d+$`.
`incorporationCountry`	Obrigatório	STRING	Exatamente 2 caracteres. Deve corresponder a `^[A-Z]+$`.

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} .'-]+(?<![ .'-])$`.
`phone`	Obrigatório	STRING	Número de telefone. De 8 a 16 caracteres. Deve corresponder a `^\+[1-9]\d+$`.

Instrumento financeiro do beneficiário

Defina financialInstrumentType: NG_BANK_PAYOUT e currency: NGN. Forneça os campos a seguir no objeto do payment rail ngBankPayout. Consulte Criar e gerenciar instrumentos financeiros para o fluxo da API.

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} .,'&\/()-]+(?<![ .,'&\/-])?$`.
`bankCode`	Obrigatório	STRING	De 1 a 50 caracteres. Deve corresponder a `^([A-Za-z0-9 ._-]+\|RPL:[A-Z]{2}:[A-Z0-9]{7,11}(_\d+)?:(BNK\|WAL))$`. Use a consulta Códigos bancários e selecione Nigéria para encontrar o Ripple Bank Code.
`accountNumber`	Obrigatório	STRING	O número da conta da identidade associado ao Account Identification Scheme. De 4 a 21 caracteres. Deve corresponder a `^[a-zA-Z0-9]+$`.

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} .'-]+(?<![ .'-])$`.
`phone`	Obrigatório	STRING	Número de telefone. De 8 a 16 caracteres. Deve corresponder a `^\+[1-9]\d+$`.

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} .'-]+(?<![ .'-])$`.
`phone`	Obrigatório	STRING	Número de telefone. De 8 a 16 caracteres. Deve corresponder a `^\+[1-9]\d+$`.

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
`purposeCode`	Finalidade do pagamento	Obrigatório	ENUM	Máximo de 5 caracteres. Consulte os valores válidos abaixo.

Códigos de finalidade do pagamento

Envie um dos valores a seguir em purposeCode.

Código	Descrição
`ACCT`	Gestão de conta
`ADCS`	Serviços de assessoria, doação e direitos autorais
`ADVA`	Pagamento antecipado
`AEMP`	Política ativa de emprego
`AGRT`	Transferência agrícola
`AIRB`	Aéreo
`ALLW`	Auxílio
`ALMY`	Pagamento de pensão alimentícia
`ANNI`	Anuidade
`ANTS`	Serviços de anestesia
`AREN`	Lançamento de contas a receber
`BBSC`	Programa de bônus por nascimento
`BCDM`	Cheque ao portador nacional
`BCFG`	Cheque ao portador internacional
`BECH`	Benefício por filho
`BFWD`	Contrato a termo de títulos
`BKDF`	Financiamento de empréstimo bancário com saque diferido
`BKFE`	Tarifas de empréstimo bancário
`BKFM`	Memorando de liberação de empréstimo bancário
`BKIP`	Pagamento de juros acumulados de empréstimo bancário
`BKPP`	Amortização de principal de empréstimo bancário
`BLDM`	Manutenção predial
`BNET`	Compensação de contrato a termo de títulos
`BOCE`	Lançamento de conversão de back office
`BONU`	Pagamento de bônus
`BUSB`	Ônibus
`CAFI`	Taxa de administração de custódia interna
`CASH`	Transferência de gestão de caixa
`CBFF`	Formação de capital
`CBFR`	Formação de capital para aposentadoria
`CBLK`	Compensação em lote de cartões
`CBTV`	Conta de TV a cabo
`CCHD`	Indenização em dinheiro, incapacidade, invalidez
`CCIR`	Swap de taxa de juros entre moedas
`CCRD`	Pagamento de cartão de crédito
`CDBL`	Fatura de cartão de crédito
`CDCB`	Pagamento com cartão com cashback
`CDCD`	Desembolso em espécie com liquidação em espécie
`CDCS`	Desembolso em espécie com sobretaxa
`CDDP`	Pagamento diferido com cartão
`CDEP`	Pagamento por evento de inadimplência de crédito
`CDOC`	Crédito original
`CDQC`	Quase-dinheiro
`CFDI`	Capital com vencimento interno
`CFEE`	Taxa de cancelamento
`CGDD`	Débito direto gerado por cartão
`CHAR`	Pagamento a instituição de caridade
`CLPR`	Amortização de principal de financiamento de veículo
`CMDT`	Transferência de mercadorias
`COLL`	Pagamento de cobrança
`COMC`	Pagamento comercial
`COMM`	Comissão
`COMP`	Pagamento de remuneração
`COMT`	Pagamento consolidado de terceiro para consumidor
`CORT`	Pagamento de liquidação de operação
`COST`	Custos
`CPKC`	Tarifas de estacionamento
`CRDS`	Swap de crédito
`CRPR`	Produto cruzado
`CRSP`	Garantia de crédito
`CRTL`	Linha de crédito
`CSDB`	Desembolso em espécie para gestão de caixa
`CSLP`	Pagamento ao banco de empréstimo social da empresa
`CVCF`	Casa de repouso
`DBTC`	Pagamento de cobrança a débito
`DCRD`	Pagamento com cartão de débito
`DEPT`	Depósito
`DERI`	Derivativos
`DIVD`	Dividendos
`DMEQ`	Equipamento médico durável
`DNTS`	Serviços odontológicos
`DSMT`	Desembolso por ordem impressa
`DVPM`	Entrega contra pagamento
`ECPR`	Devolução de pagamento eletrônico
`ECPU`	Pagamento eletrônico sem garantia
`EDUC`	Educação
`ELEC`	Conta de energia elétrica
`ENRG`	Energia
`EQPT`	Opção de ações
`EQUS`	Swap de ações
`ESTX`	Imposto sobre herança
`ETUP`	Recarga de carteira eletrônica
`EXPT`	Opção exótica
`EXTD`	Derivativos negociados em bolsa
`FACT`	Pagamento relacionado a atualização de fator
`FAMI`	Pagamentos relacionados a apoio familiar
`FAND`	Auxílio financeiro em caso de desastre natural
`FCOL`	Cobrança de tarifas
`FCPM`	Pagamento em atraso de tarifas e encargos
`FEES`	Pagamento de tarifas
`FERB`	Balsa
`FIXI`	Renda fixa
`FNET`	Pagamento de compensação de futuros
`FORW`	Câmbio a termo
`FREX`	Câmbio
`FUTR`	Futuros
`FWBC`	Garantia em dinheiro a termo de propriedade do corretor
`FWCC`	Garantia em dinheiro a termo de propriedade do cliente
`FWLV`	Taxa sobre trabalhador estrangeiro
`FWSB`	Garantia em dinheiro a termo segregada de propriedade do corretor
`FWSC`	Garantia em dinheiro a termo segregada de propriedade do cliente
`FXNT`	Compensação relacionada a câmbio
`GASB`	Conta de gás
`GDDP`	Compra ou venda de mantimentos
`GDDS`	Compra ou venda de bens
`GDFR`	Compra ou venda de bens de moda e cosméticos de varejo
`GDSV`	Compra e venda de bens e serviços
`GELE`	Compra ou venda de bens eletrônicos
`GFRP`	Pagamento de direitos de fundo garantidor
`GIFT`	Doação
`GOVI`	Seguro governamental
`GOVT`	Pagamento governamental
`GSCB`	Compra e venda de bens e serviços com cashback
`GSTX`	Imposto sobre bens e serviços
`GTOY`	Compra ou venda de brinquedos
`GVEA`	Servidores públicos austríacos, Categoria A
`GVEB`	Servidores públicos austríacos, Categoria B
`GVEC`	Servidores públicos austríacos, Categoria C
`GVED`	Servidores públicos austríacos, Categoria D
`HEDG`	Hedge
`HLRP`	Pagamento de financiamento habitacional
`HLST`	Liquidação de financiamento habitacional
`HLTC`	Atendimento domiciliar de saúde
`HLTI`	Plano de saúde
`HREC`	Contribuição relacionada a habitação
`HSPC`	Assistência hospitalar
`HSTX`	Imposto sobre habitação
`ICCP`	Pagamento irrevogável com cartão de crédito
`ICRF`	Instituição de cuidados intermediários
`IDCP`	Pagamento irrevogável com cartão de débito
`INPC`	Prêmio de seguro de automóvel
`INPR`	Reembolso de prêmio de seguro
`INSC`	Pagamento de sinistro de seguro
`INSM`	Parcela
`INSU`	Prêmio de seguro
`INTE`	Juros
`INTX`	Imposto de renda
`INVS`	Investimento e valores mobiliários
`IPAY`	Pagamentos instantâneos
`IPCA`	Cancelamento de pagamentos instantâneos
`IPDO`	Pagamentos instantâneos para doações
`IPEA`	Pagamentos instantâneos em comércio eletrônico sem dados de endereço
`IPEC`	Pagamentos instantâneos em comércio eletrônico com dados de endereço
`IPEW`	Pagamentos instantâneos em comércio eletrônico
`IPPS`	Pagamentos instantâneos em POS
`IPRT`	Devolução de pagamentos instantâneos
`IPU2`	Pagamentos instantâneos em máquina de autoatendimento com 2FA
`IPUW`	Pagamentos instantâneos em máquina de autoatendimento sem 2FA
`IVPT`	Pagamento de fatura
`LBIN`	Compensação de recompra em empréstimo de ativos
`LBRI`	Seguro trabalhista
`LCOL`	Movimentação livre de garantia em dinheiro de empréstimo de ativos
`LFEE`	Tarifas de empréstimo de ativos
`LICF`	Taxa de licença
`LIFI`	Seguro de vida
`LIMA`	Gestão de liquidez
`LMEQ`	Garantia em dinheiro marcada a mercado de empréstimo de ações
`LMFI`	Garantia em dinheiro marcada a mercado de empréstimo de renda fixa
`LMRK`	Garantia em dinheiro marcada a mercado de empréstimo de ativos de tipo não especificado
`LOAN`	Empréstimo
`LOAR`	Pagamento de empréstimo
`LREB`	Pagamentos de abatimento de empréstimo de ativos
`LREV`	Pagamentos de receita de empréstimo de ativos
`LSFL`	Pagamento de reivindicação de empréstimo de ativos
`LTCF`	Instituição de cuidados de longa permanência
`MAFC`	Contribuição a fundo de assistência médica
`MARF`	Reembolso de assistência médica
`MARG`	Margem diária de derivativos listados
`MBSB`	Garantia em dinheiro de MBS de propriedade do corretor
`MBSC`	Garantia em dinheiro de MBS de propriedade do cliente
`MDCS`	Serviços médicos
`MGCC`	Margem inicial de futuros
`MGSC`	Garantia em dinheiro segregada de margem inicial de futuros de propriedade do cliente
`MISC`	Diversos
`MP2B`	Pagamento P2B móvel
`MP2P`	Pagamento P2P móvel
`MSVC`	Múltiplos tipos de serviço
`MTUP`	Recarga de celular
`NETT`	Compensação
`NITX`	Imposto de renda líquido
`NOWS`	Não especificado de outra forma
`NWCH`	Tarifa de rede
`NWCM`	Comunicação de rede
`OCCC`	Garantia empenhada na OCC de propriedade do cliente
`OCDM`	Cheque administrativo nacional
`OCFG`	Cheque administrativo internacional
`OFEE`	Taxa de abertura
`OPBC`	Garantia em dinheiro de opção de balcão de propriedade do corretor
`OPCC`	Garantia em dinheiro de opção de balcão de propriedade do cliente
`OPSB`	Garantia em dinheiro segregada de opção de balcão de propriedade do corretor
`OPSC`	Garantia em dinheiro segregada de opção de balcão de propriedade do cliente
`OTCD`	Derivativos de balcão
`OTHR`	Outro
`OTLC`	Outra conta relacionada a telecomunicações
`PADD`	Débito pré-autorizado
`PAYR`	Folha de pagamento
`PEFC`	Contribuição a fundo de pensão
`PENO`	Pagamento com base em ordem de execução
`PENS`	Pagamento de aposentadoria
`PHON`	Conta de telefone
`POPE`	Lançamento em ponto de compra
`PPTI`	Seguro patrimonial
`PRCP`	Pagamento de preço
`PRME`	Metal precioso
`PTSP`	Condições de pagamento
`PTXP`	Imposto sobre a propriedade
`RCKE`	Lançamento de cheque reapresentado
`RCPT`	Pagamento de recibo
`RDTX`	Imposto sobre veículos
`REBT`	Abatimento
`REFU`	Reembolso
`RELG`	Aluguel geral
`REMT`	Remessa
`RENT`	Aluguel
`REOD`	Pagamento de cheque especial
`REPO`	Operação compromissada
`RHBS`	Auxílio-reabilitação
`RIMB`	Reembolso de transação anterior equivocada
`RINP`	Pagamento de parcela recorrente
`RLWY`	Ferroviário
`ROYA`	Royalties
`RPBC`	Garantia de operação compromissada bilateral de propriedade do corretor
`RPCC`	Garantia de operação compromissada de propriedade do cliente
`RPNT`	Compensação pela internet de operação compromissada bilateral
`RPSB`	Garantia em dinheiro segregada de operação compromissada bilateral de propriedade do corretor
`RPSC`	Garantia em dinheiro segregada de operação compromissada bilateral de propriedade do cliente
`RRBN`	Rodízio
`RRCT`	Transferência de crédito de reembolso recebida
`RVPM`	Recebimento contra pagamento
`RVPO`	Operação compromissada reversa
`SALA`	Pagamento de salário
`SAVG`	Poupança
`SBSC`	Compra e venda com recompra de valores mobiliários
`SCEX`	Compra ou venda de serviços de exposição
`SCHR`	Compra ou venda de serviços de recursos humanos
`SCIE`	Swap exótico de taxa de juros em moeda única
`SCIN`	Compra ou venda de serviços de interpretação
`SCIR`	Swap de taxa de juros em moeda única
`SCRP`	Produtos cruzados de valores mobiliários
`SCSD`	Compra ou venda de serviços de desenvolvimento de software
`SCTS`	Compra ou venda de serviços de tradução
`SCTX`	Imposto sobre serviços
`SCVE`	Compra e venda de serviços
`SCWD`	Compra ou venda de serviços de design ou desenvolvimento web
`SECU`	Valores mobiliários
`SEPI`	Compra interna de valores mobiliários
`SERV`	Tarifas de serviço
`SHBC`	Garantia de venda a descoberto de propriedade do corretor
`SHCC`	Garantia de venda a descoberto de propriedade do cliente
`SHSL`	Venda a descoberto
`SLEB`	Empréstimo e tomada de valores mobiliários
`SLOA`	Empréstimo garantido
`SLPI`	Instrução de boleto de pagamento
`SPLT`	Pagamentos divididos
`SPSP`	Pagamento de salário ou pensão
`SRAG`	Compra ou venda de serviços de corretagem imobiliária
`SSBE`	Benefício previdenciário
`STDY`	Estudos
`SUBS`	Assinatura
`SUPP`	Pagamento a fornecedor
`SWBC`	Garantia em dinheiro de swap de propriedade do corretor
`SWCC`	Garantia em dinheiro de swap de propriedade do cliente
`SWFP`	Pagamento final de contrato de swap
`SWPP`	Pagamento parcial de contrato de swap
`SWPT`	Swaption
`SWRS`	Pagamento de redefinição de contrato de swap
`SWSB`	Garantia em dinheiro segregada de swaps de propriedade do corretor
`SWSC`	Garantia em dinheiro segregada de swaps de propriedade do cliente
`SWUF`	Pagamento inicial de contrato de swap
`TAXR`	Restituição de imposto
`TAXS`	Pagamento de tributos
`TBAN`	Compensação por casamento de TBA
`TBAS`	A ser anunciado
`TBBC`	Garantia em dinheiro de TBA de propriedade do corretor
`TBCC`	Garantia em dinheiro de TBA de propriedade do cliente
`TBIL`	Conta de telecomunicações
`TCSC`	Tarifas de serviços municipais
`TELI`	Transação iniciada por telefone
`TLRF`	Pagamento de taxa recorrente de fundo mútuo fora dos EUA
`TLRR`	Pagamento de abatimento de taxa recorrente de fundo mútuo fora dos EUA
`TMPG`	Pagamento de reivindicação TMPG
`TRAD`	Serviços comerciais
`TRCP`	Produto cruzado de tesouraria
`TREA`	Pagamento de tesouraria
`TRFD`	Fundo fiduciário
`TRNC`	Boleto de pagamento truncado
`TRPT`	Pedágio urbano
`TRVC`	Cheque de viagem
`UBIL`	Serviços públicos
`UNIT`	Compra de cotas de fundo
`VATX`	Pagamento de imposto sobre valor agregado
`VIEW`	Assistência oftalmológica
`WEBI`	Transação iniciada pela internet
`WHLD`	Retenção
`WTER`	Conta de água