GuidesSuporteAPI Reference

Ambiente de teste para prova de vida


Validação de Identidade

Compliance com a Circular 3.978/20 do Banco Central

Tanto para atender as diretrizes do BACEN quanto para fortalecer a segurança e capacidade de prevenção a fraude da nossa plataforma, introduziremos a Validação de Identidade com Prova de Vida (KYC) como obrigatória também para os recebedores de marketplaces.

Com o objetivo de facilitar a adaptação no novo processo de Validação de Identidade, disponibilizaremos uma webapp em que os recebedores poderão passar pelo processo de KYC com biometria.

No fluxo de criação de um recebedor, será disponibilizado um QR Code de acesso ao webapp, que deverá ser renderizado pelo Marketplace e disponibilizado para que o recebedor finalize seu processo de credenciamento.

Para o detalhamento das mudanças, fluxos e contratos de API sobre o novo fluxo de Validação de Identidade com Prova de Vida, acesse as páginas abaixo:


Sandbox

Foram criadas duas rotas para testar os fluxos de Validação de Identidade com Prova de Vida (KYC). Ambas as rotas não tem autenticação, por se tratar de um mock e apenas simulam as respostas dessas rotas em produção.


CreateQrCode

Essa rota simula a criação do do link para o preenchimento do KYC (Passo 3 do Fluxo de credenciamento do recebedor).

Rota: https://api.mundipagg.com/lifecycle/v1/kycs-mock/qr-code
Method: POST

Esta rota não tem necessidade de envio de payload, ela pega os parâmetros via query string, aceitando o campo customId = ID do Recebedor

Exemplo:

https://api.mundipagg.com/lifecycle/v1/kycs-mock/qr-code?customId=ID_DO_RECEBEDOR

Segue exemplo de response dessa rota: 

{
  "url":"https://exemplo.com/kyc?token=eyWfwqrnqwrnfoqwntoqwntqw",
  "base64_qrcode":"PD94bWwgd...",
  "expires_at":"2023-10-25T17:08:31.444-03:00"
}

CreatePaymentBankAccount

Essa rota simula o preenchimento do recebedor e retorno da análise do KYC (Passos 5 e 6 do Fluxo de credenciamento do recebedor).

Rota: https://api.mundipagg.com/lifecycle/v1/kycs-mock/create-payment-bank-account?status=XXXXXXXX&statusReason=XXXXXX
Method: POST

Nessa rota é necessário passar um payload com os campos para simular a criação da conta de pagamento. No mock, adicionamos duas query string para poder simular o retorno: Status e StatusReason

  • status: approved ou denied
  • statsureason: ok, fully_denied ou partially_denied

Exemplo de payload:

{
    "acquisition_channel": "marketplace",
    "company_id": "ID da loja",
    "custom_id": "ID do Recebedor",
    "document": "52808963000110",
    "document_type": "cnpj",
    "email": "[email protected]",
    "name": "Name Teste 123",
    "operator": {
        "document": "17457268960",
        "name": "Name Teste"
    },
    "type": "marketplace"
}

Exemplo de Response:

[
    {
        "kyc_id": "string",
        "kyc_status": "string",
        "kyc_status_reason": "string",
        "user_id": int,
        "company_id": "string",
        "custom_id": "string",
        "acquisition_channel": "string",
        "account_manager_email": "string",
        "created_at": "date",
        "updated_at": "date"
    }
]