Recursos para IA

Atualização da integração

Importante
A Circular BCB nº3978/2020 determina que todos os Facilitadores de Pagamento identifiquem os beneficiários finais no momento da transação. Para cumprimento desta norma, é obrigatório enviar os parâmetros da propriedade sub_merchant que são detalhados na tabela abaixo. Caso os campos não sejam enviados, a bandeira poderá aplicar penalidades que serão repassadas ao Facilitador de Pagamento.

Para utilizar a integração do Facilitador de Pagamento, é necessário atualizar a propriedade forward_data.sub_merchant para o envio dos campos descritos abaixo.

{
  "payer": {...},
  "forward_data": {
    "sub_merchant": {
      "sub_merchant_id": 123123,
      "mcc": "5462",
      "country": "BRA",
      "address_door_number": 1,
      "zip": "2222222",
      "document_number": "222222222222222",
      "city": "SÃO PAULO",
      "address_street": "RUA A",
	    "legal_name": "LOJINHA DO ZÉ",
      "region_code_iso": "BR-MG",
      "region_code": "BR",
      "document_type": "CNPJ",
      "phone": "123123123",
      "url": "www.nomedofacilitador.com.br"
    }
  },
  "transaction_amount": 20,
  "description": "...",
  "token": "....",
  "statement_descriptor": "PRUEBA",
  "issuer_id": ...,
  "payment_method_id": "...",
  "amounts": {...},
  "installments": 1,
  "pos_id": "....",
  "external_reference": "..."
}
CampoTipoDescriçãoObrigatoriedadeExemplo
sub_merchant_idNúmeroCódigo do subcomerciante.Obrigatório123123
mccTextoMCC do sub comércio conforme deliberação da Abecs e/ou CNAE primário.Obrigatório5462
countryTextoPaís em que o subcomerciante está localizado.ObrigatórioBRA
address_door_numberNúmeroNúmero da rua onde o subcomerciante está localizado.Obrigatório1
zipTextoCEP do subcomerciante.Obrigatório2222222
document_numberTextoIdentificação do número do documento do subcomerciante.Obrigatório222222222222222
cityTextoCidade onde o subcomerciante está localizado.ObrigatórioSÃO PAULO
address_streetTextoRua onde o subcomerciante está localizado.ObrigatórioRUA A
legal_nameTextoRazão social do subcomerciante.ObrigatórioLOJINHA DO ZÉ
region_code_isoTextoEstado onde o subcomerciante está localizado.ObrigatórioBR-MG
region_codeTextoIdentificação da abreviação do estado do subcomerciante.ObrigatórioMG
document_typeTextoIdentificação do tipo de documento do subcomerciante, podendo ser: CPF ou CNPJ.ObrigatórioCNPJ
phoneTextoTelefone do subcomerciante.Obrigatório123123123
urlTextoURL do Facilitador de pagamentoObrigatóriowww.nomedofacilitador.com.br