Jornadas de Credenciamento — Visão Geral

1. O que é o Credenciamento?

O credenciamento é o processo pelo qual um estabelecimento comercial (merchant) passa a fazer parte da rede Getnet, habilitando-se a aceitar pagamentos com cartão e outros meios eletrônicos. Durante esse processo são coletados dados cadastrais, realizada análise de risco e compliance (qualificação), definidas as ofertas comerciais contratadas e criado o pedido formal que consolida tudo isso.

2. Tipos de Jornada

3. Autenticação — Pré-requisito de Ambas as Jornadas

Text

[Sua Aplicação] ──POST /token──────────────────────► [Authentication API] (credenciais nos headers + body) ◄──200 OK { access_token, expires_in }── [Sua Aplicação] ──Requisição + Authorization: {access_token}──► [Demais APIs] ◄──Resposta da operação──────────────────────────────── ↺ Repita o POST /token quando expires_in se aproximar do fim.

Text

1

2

3

4

5

6

7

8

[Sua Aplicação] ──POST /token──────────────────────► [Authentication API] (credenciais nos headers + body) ◄──200 OK { access_token, expires_in }── [Sua Aplicação] ──Requisição + Authorization: {access_token}──► [Demais APIs] ◄──Resposta da operação──────────────────────────────── ↺ Repita o POST /token quando expires_in se aproximar do fim.

📄 Detalhes completos em POST /token

4. Jornada 1 — Credenciamento Autônomo (Mar Aberto)

4.1 Visão macro do fluxo

Text

[Autenticação] │ ▼ [Vitrine de Ofertas] ←── Merchant escolhe um plano/oferta │ ▼ [Etapa 0] Verificação prévia — documento já possui EC? │ não ▼ [Etapa 1] Criação do merchant (dados mínimos) │ ▼ [Etapa 1.5] Consulta de CEP + Opções de frete │ ▼ [Etapa 2] Complemento de dados (PUT /merchants) │ ▼ [Etapa 3] Qualificação (análise de risco) │ aprovado ▼ [Etapa 4] Resultado da qualificação confirmado │ ▼ [Etapa 5-6] Montagem dos itens do pedido (offerings → items) │ ▼ [Etapa 7] Informação de dados bancários │ ▼ [Etapa 8] Criação do pedido → POST /orders │ ▼ [Etapa 8.5] Atualização do pedido → PUT /orders/{id} *(quando necessário)* │ ▼ [Etapa 9] Validação do pedido → POST /orders/{id}/validation │ aprovado ▼ [Etapa 10] Submissão do pedido → PUT /orders/{id}/submit │ ▼ [Credenciamento concluído — order_number gerado]

Text

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

[Autenticação] │ ▼ [Vitrine de Ofertas] ←── Merchant escolhe um plano/oferta │ ▼ [Etapa 0] Verificação prévia — documento já possui EC? │ não ▼ [Etapa 1] Criação do merchant (dados mínimos) │ ▼ [Etapa 1.5] Consulta de CEP + Opções de frete │ ▼ [Etapa 2] Complemento de dados (PUT /merchants) │ ▼ [Etapa 3] Qualificação (análise de risco) │ aprovado ▼ [Etapa 4] Resultado da qualificação confirmado │ ▼ [Etapa 5-6] Montagem dos itens do pedido (offerings → items) │ ▼ [Etapa 7] Informação de dados bancários │ ▼ [Etapa 8] Criação do pedido → POST /orders │ ▼ [Etapa 8.5] Atualização do pedido → PUT /orders/{id} *(quando necessário)* │ ▼ [Etapa 9] Validação do pedido → POST /orders/{id}/validation │ aprovado ▼ [Etapa 10] Submissão do pedido → PUT /orders/{id}/submit │ ▼ [Credenciamento concluído — order_number gerado]

4.2 Detalhamento das etapas

🔐 Autenticação

📄 POST /token

🛍️ Vitrine de Ofertas

Antes de iniciar o cadastro, consulte as ofertas disponíveis para o canal e país. Isso permite que o merchant escolha um plano antes de se cadastrar.

Text

Consumidor ──GET /offerings?country=BR&channel={canal}──► Offerings API ◄── Lista de ofertas (sem taxas de adquirência) ── Consumidor ──GET /offerings?priced_offering_id={id}──► Offerings API ◄── Objeto único com taxas detalhadas por bandeira ── └─ {id} = priced_offering_id retornado na listagem anterior OU (em uma única chamada) Consumidor ──GET /offerings?country=BR&channel={canal}&show_acquirers=true──► Offerings API ◄── Lista de ofertas já com taxas incluídas ──

Text

1

2

3

4

5

6

7

8

9

10

11

Consumidor ──GET /offerings?country=BR&channel={canal}──► Offerings API ◄── Lista de ofertas (sem taxas de adquirência) ── Consumidor ──GET /offerings?priced_offering_id={id}──► Offerings API ◄── Objeto único com taxas detalhadas por bandeira ── └─ {id} = priced_offering_id retornado na listagem anterior OU (em uma única chamada) Consumidor ──GET /offerings?country=BR&channel={canal}&show_acquirers=true──► Offerings API ◄── Lista de ofertas já com taxas incluídas ──

📄 GET /offerings

Etapa 0 — Verificação prévia (opcional, mas recomendada)

Text

GET /establishment-contracts-basic/legal-document-number/{cpf_cnpj}/ec-accredited ├── accredited: true ──► Documento já possui EC. Interromper fluxo. └── accredited: false ──► Pode cadastrar. Seguir para Etapa 1.

Text

1

2

3

4

GET /establishment-contracts-basic/legal-document-number/{cpf_cnpj}/ec-accredited ├── accredited: true ──► Documento já possui EC. Interromper fluxo. └── accredited: false ──► Pode cadastrar. Seguir para Etapa 1.

Etapa 1 — Criação do merchant (dados mínimos)

Text

POST /merchants │ Enviar: CPF/CNPJ + dados pessoais básicos + opt-ins (LGPD + termos) │ Retorna: merchant_id + sub_status_steps (etapas pendentes) │ └──► Guardar o merchant_id para usar nas etapas seguintes.

Text

1

2

3

4

5

6

7

POST /merchants │ Enviar: CPF/CNPJ + dados pessoais básicos + opt-ins (LGPD + termos) │ Retorna: merchant_id + sub_status_steps (etapas pendentes) │ └──► Guardar o merchant_id para usar nas etapas seguintes.

⚠️ Guarde o merchant_id retornado — ele é obrigatório em todas as próximas chamadas.

📄 POST /merchants

Etapa 1.5 — Consulta de CEP e opções de entrega (quando necessário)

Valide o CEP informado pelo merchant e consulte as opções de entrega disponíveis para aquele endereço.

Text

GET /domains/zipcode/{postal_code} │ ├─► 200 — CEP encontrado │ └─► Pré-preencher campos de endereço │ Solicitar ao merchant: número e complemento │ └─► 404 — CEP não encontrado └─► Informar ao merchant que o CEP digitado é inválido ou não foi encontrado, e solicitar que informe um novo CEP válido antes de prosseguir. GET /offerings/delivery-data?legal_document_number={doc}&postal_code={cep}&ids={offering_id_1},{offering_id_2} │ ├─ Parâmetros obrigatórios: │ ├─ legal_document_number — CPF ou CNPJ do merchant │ └─ postal_code — CEP do endereço de entrega │ ├─ Parâmetros opcionais: │ └─ ids — Um ou mais IDs de oferta (offering_id ou reference_id) separados por vírgula, │ para consultar o frete específico dos produtos contidos nessa(s) oferta(s). │ └── Retorna opções de entrega disponíveis (normal, expressa, agendada)

Text

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

GET /domains/zipcode/{postal_code} │ ├─► 200 — CEP encontrado │ └─► Pré-preencher campos de endereço │ Solicitar ao merchant: número e complemento │ └─► 404 — CEP não encontrado └─► Informar ao merchant que o CEP digitado é inválido ou não foi encontrado, e solicitar que informe um novo CEP válido antes de prosseguir. GET /offerings/delivery-data?legal_document_number={doc}&postal_code={cep}&ids={offering_id_1},{offering_id_2} │ ├─ Parâmetros obrigatórios: │ ├─ legal_document_number — CPF ou CNPJ do merchant │ └─ postal_code — CEP do endereço de entrega │ ├─ Parâmetros opcionais: │ └─ ids — Um ou mais IDs de oferta (offering_id ou reference_id) separados por vírgula, │ para consultar o frete específico dos produtos contidos nessa(s) oferta(s). │ └── Retorna opções de entrega disponíveis (normal, expressa, agendada)

📄 GET /offerings/delivery-data · GET /domains/zipcode/{postal_code}

Etapa 2 — Complemento de dados (quando necessário)

Text

GET /merchants/{merchant_id} │ Alterar somente os campos necessários no payload retornado │ PUT /merchants/{merchant_id} │ Enviar: renda, patrimônio, endereços, horário de funcionamento, etc.

Text

1

2

3

4

5

6

7

GET /merchants/{merchant_id} │ Alterar somente os campos necessários no payload retornado │ PUT /merchants/{merchant_id} │ Enviar: renda, patrimônio, endereços, horário de funcionamento, etc.

⚠️ Nunca envie payload parcial. O PUT substitui todos os dados do merchant. Sempre busque o objeto completo com GET antes de modificá-lo.

📄 PUT /merchants/{merchant_id}

Etapa 3 — Qualificação (análise de risco e compliance)

Text

POST /merchants/{merchant_id}/qualification │ └── Retorna: report.recommended.status + report.details[]

Text

1

2

3

POST /merchants/{merchant_id}/qualification │ └── Retorna: report.recommended.status + report.details[]

📄 POST /merchants/{merchant_id}/qualification

Etapa 4 — Resultado da qualificação

Text

report.recommended.status │ ├── "approved" ──► Merchant aprovado. │ Prosseguir com o credenciamento normalmente. │ ├── "pending" ──► Merchant em análise manual pelo time de riscos. │ Prosseguir com o credenciamento normalmente; │ o resultado final será definido pela equipe de risco. │ └── "reproved" ──► Merchant reprovado. Não poderá realizar negócios com a Getnet. Consultar motivo em: report.details[*].detail_description

Text

1

2

3

4

5

6

7

8

9

10

11

report.recommended.status │ ├── "approved" ──► Merchant aprovado. │ Prosseguir com o credenciamento normalmente. │ ├── "pending" ──► Merchant em análise manual pelo time de riscos. │ Prosseguir com o credenciamento normalmente; │ o resultado final será definido pela equipe de risco. │ └── "reproved" ──► Merchant reprovado. Não poderá realizar negócios com a Getnet. Consultar motivo em: report.details[*].detail_description

📄 GET /merchants/{merchant_id}/qualification

Etapas 5 e 6 — Montagem dos itens do pedido

Para cada oferta selecionada pelo merchant, mapeie cada item da oferta para um item do pedido:

Text

Para cada oferta selecionada: └─ Para cada item em offering.items[]: ├─ item_sequence_number = próximo número sequencial global ├─ offering.priced_offering_id = offering.priced_offering_id (raiz da oferta) ├─ offering.smart_offering_id = offering.priced_offering_id (raiz da oferta) ├─ product = item.product (cópia integral) ├─ quantity = quantidade informada pelo cliente (item.quantity é apenas a quantidade inicial sugerida pela oferta) ├─ settlement_period = item.settlement_period (se presente) ├─ unit_price = item.unit_price (se presente) └─ total_price = item.total_price (se presente)

Text

1

2

3

4

5

6

7

8

9

10

Para cada oferta selecionada: └─ Para cada item em offering.items[]: ├─ item_sequence_number = próximo número sequencial global ├─ offering.priced_offering_id = offering.priced_offering_id (raiz da oferta) ├─ offering.smart_offering_id = offering.priced_offering_id (raiz da oferta) ├─ product = item.product (cópia integral) ├─ quantity = quantidade informada pelo cliente (item.quantity é apenas a quantidade inicial sugerida pela oferta) ├─ settlement_period = item.settlement_period (se presente) ├─ unit_price = item.unit_price (se presente) └─ total_price = item.total_price (se presente)

Etapa 6.5 — Montagem do endereço de entrega (delivery_info)

Text

delivery_info ├─ delivery_type = tipo selecionado pelo merchant ("scheduled" / "normal" / "express") ├─ delivery_amount = delivery_methods[x].delivery_amount ├─ delivery_time = delivery_methods[x].delivery_time │ ├─ [se "normal" ou "express"] │ └─ delivery_time_type = delivery_methods[x].delivery_time_type ("D" = dias / "H" = horas) │ ├─ [se "scheduled"] │ ├─ recommended_delivery_period = período selecionado pelo merchant ("morning" / "afternoon" / "night") │ ├─ period_grid = entrada de delivery_methods[x].period_grid[] correspondente ao período │ └─ delivery_time_type = null │ ├─ delivery_reference_point = ponto de referência informado pelo merchant (opcional) │ └─ delivery_address = endereço de entrega informado pelo merchant ├─ street = logradouro (retornado pelo GET /domains/zipcode) ├─ number = número (informado pelo merchant) ├─ complement = complemento (informado pelo merchant, opcional) ├─ district = bairro (retornado pelo GET /domains/zipcode) ├─ city = cidade (retornado pelo GET /domains/zipcode) ├─ state = UF (retornado pelo GET /domains/zipcode) ├─ postal_code = CEP validado na Etapa 1.5 └─ country = "BR"

Text

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

delivery_info ├─ delivery_type = tipo selecionado pelo merchant ("scheduled" / "normal" / "express") ├─ delivery_amount = delivery_methods[x].delivery_amount ├─ delivery_time = delivery_methods[x].delivery_time │ ├─ [se "normal" ou "express"] │ └─ delivery_time_type = delivery_methods[x].delivery_time_type ("D" = dias / "H" = horas) │ ├─ [se "scheduled"] │ ├─ recommended_delivery_period = período selecionado pelo merchant ("morning" / "afternoon" / "night") │ ├─ period_grid = entrada de delivery_methods[x].period_grid[] correspondente ao período │ └─ delivery_time_type = null │ ├─ delivery_reference_point = ponto de referência informado pelo merchant (opcional) │ └─ delivery_address = endereço de entrega informado pelo merchant ├─ street = logradouro (retornado pelo GET /domains/zipcode) ├─ number = número (informado pelo merchant) ├─ complement = complemento (informado pelo merchant, opcional) ├─ district = bairro (retornado pelo GET /domains/zipcode) ├─ city = cidade (retornado pelo GET /domains/zipcode) ├─ state = UF (retornado pelo GET /domains/zipcode) ├─ postal_code = CEP validado na Etapa 1.5 └─ country = "BR"

Etapa 7 — Dados bancários (domicílio bancário)

Para cada bandeira contratada, informe os dados da conta bancária onde o merchant receberá os valores.

Text

merchant_accounts[] — um item por bandeira contratada: ├─ brand = bandeira (visa / master / elo / amex / ...) ├─ merchant.merchant_id = merchant_id (Etapa 1) ├─ bank_account.bank.bank_code = código FEBRABAN do banco ├─ bank_account.bank_branch_code = agência ├─ bank_account.bank_account_number = conta + dígito ├─ bank_account.account_type = cc / pp ├─ payment_center = true / false └─ merchant_account_restriction = []

Text

1

2

3

4

5

6

7

8

9

merchant_accounts[] — um item por bandeira contratada: ├─ brand = bandeira (visa / master / elo / amex / ...) ├─ merchant.merchant_id = merchant_id (Etapa 1) ├─ bank_account.bank.bank_code = código FEBRABAN do banco ├─ bank_account.bank_branch_code = agência ├─ bank_account.bank_account_number = conta + dígito ├─ bank_account.account_type = cc / pp ├─ payment_center = true / false └─ merchant_account_restriction = []

📄 Banks

Etapa 8 — Criação do pedido

Com todos os dados coletados, crie o pedido formal de credenciamento.

Text

total_fixed_price ← Σ total_price dos terminais com pricing_type = "fixed_price" total_monthly_rent ← Σ total_price dos terminais com pricing_type = "monthly_rent" total_affiliation_fee ← Σ total_price dos terminais com pricing_type = "affiliation_fee" total_recurrent ← Σ total_price dos terminais com pricing_type = "recurrent" total_payment_price ← Σ total_price dos terminais com pricing_type = "payment_price" total_license ← Σ total_price dos terminais com pricing_type = "license"

Text

1

2

3

4

5

6

total_fixed_price ← Σ total_price dos terminais com pricing_type = "fixed_price" total_monthly_rent ← Σ total_price dos terminais com pricing_type = "monthly_rent" total_affiliation_fee ← Σ total_price dos terminais com pricing_type = "affiliation_fee" total_recurrent ← Σ total_price dos terminais com pricing_type = "recurrent" total_payment_price ← Σ total_price dos terminais com pricing_type = "payment_price" total_license ← Σ total_price dos terminais com pricing_type = "license"

Itens com product_type diferente de terminal (ex.: composite, service) não entram neste cálculo. Campos sem terminais correspondentes devem ser enviados com valor 0.

Text

POST /orders │ Enviar: merchant, delivery_info, items[], merchant_accounts[], total_fixed_price, total_monthly_rent, total_affiliation_fee, total_recurrent, total_payment_price, total_license │ Retorna: order_id │ └──► Guardar o order_id para usar nas etapas seguintes (validação, atualização e submissão).

Text

1

2

3

4

5

6

7

8

9

POST /orders │ Enviar: merchant, delivery_info, items[], merchant_accounts[], total_fixed_price, total_monthly_rent, total_affiliation_fee, total_recurrent, total_payment_price, total_license │ Retorna: order_id │ └──► Guardar o order_id para usar nas etapas seguintes (validação, atualização e submissão).

⚠️ Guarde o order_id retornado — ele é obrigatório em todas as próximas chamadas (PUT /orders/{order_id}, POST /orders/{order_id}/validation, PUT /orders/{order_id}/submit).

📄 POST /orders

Etapa 8.5 — Atualização do pedido (quando necessário)

Text

PUT /orders/{order_id} │ Enviar: objeto completo do pedido (com as alterações aplicadas)

Text

1

2

3

PUT /orders/{order_id} │ Enviar: objeto completo do pedido (com as alterações aplicadas)

⚠️ Nunca envie payload parcial. O PUT substitui todos os dados do pedido. Sempre envie o objeto completo.

• Se o canal armazena o pedido em seu domínio: basta modificar ou incrementar os campos na estrutura local e enviar o PUT com o objeto completo — não é necessário chamar GET /orders/{order_id} antes.
• Se o canal não armazena o pedido: chamar GET /orders/{order_id} (usando o order_id retornado no POST /orders), aplicar as alterações e enviar o PUT.

Após qualquer alteração nos itens, recalcule os campos de totalização conforme a Etapa 8.

📄 PUT /orders/{order_id}

Etapa 9 — Validação do pedido (recomendada)

Antes de submeter, valide o pedido para identificar e corrigir eventuais problemas.

Text

POST /orders/{order_id}/validation │ ├── report.recommended.status = "approved" ──► Prosseguir para submissão. │ └── report.recommended.status = "reproved" ──► Verificar e corrigir: report.details[].detail_description

Text

1

2

3

4

5

6

POST /orders/{order_id}/validation │ ├── report.recommended.status = "approved" ──► Prosseguir para submissão. │ └── report.recommended.status = "reproved" ──► Verificar e corrigir: report.details[].detail_description

⚠️ Após a submissão (Etapa 10) o pedido não pode mais ser corrigido. Use esta etapa como salvaguarda.

📄 POST /orders/{order_id}/validation

Etapa 10 — Submissão do pedido

Submeta o pedido após confirmação do merchant. Esta é a etapa final.

Text

PUT /orders/{order_id}/submit │ ├── Reprovado ──► error.report.recommended = "reproved" │ Verificar: report.details[].detail_description │ └── Submetido ──► situation.status = "submitted" order_number gerado — usar para acompanhamento do pedido │ ├─ Para verificar se o pedido foi aprovado: │ GET /orders?order_number={order_number} └─ Ou configure um webhook para receber notificações de status.

Text

1

2

3

4

5

6

7

8

9

10

11

PUT /orders/{order_id}/submit │ ├── Reprovado ──► error.report.recommended = "reproved" │ Verificar: report.details[].detail_description │ └── Submetido ──► situation.status = "submitted" order_number gerado — usar para acompanhamento do pedido │ ├─ Para verificar se o pedido foi aprovado: │ GET /orders?order_number={order_number} └─ Ou configure um webhook para receber notificações de status.

📄 PUT /orders/{order_id}/submit

5. Jornada 2 — Credenciamento Assistido

5.1 Visão macro do fluxo

Text

[Autenticação] │ ▼ [Etapa 0] Verificação prévia — documento já possui EC? │ não ▼ [Etapa 1] Criação do merchant (dados mínimos + monthly_card_income) │ └── Retorna: merchant_id + MCC ▼ [Vitrine de Ofertas] ←── Filtragem com MCC e faturamento mensal do merchant │ ▼ [Etapa 1.5] Consulta de CEP + Opções de frete │ ▼ [Etapa 2] Complemento de dados (PUT /merchants) │ ▼ [Etapa 3] Qualificação (análise de risco) │ aprovado ▼ [Etapa 4] Resultado da qualificação confirmado │ ▼ [Etapas 5-6] Montagem dos itens do pedido (offerings → items) │ ▼ [Etapa 7] Informação de dados bancários │ ▼ [Etapa 8] Criação do pedido → POST /orders │ ▼ [Etapa 8.5] Atualização do pedido → PUT /orders/{id} *(quando necessário)* │ ▼ [Etapa 9] Validação do pedido → POST /orders/{id}/validation │ aprovado ▼ [Etapa 10] Submissão do pedido → PUT /orders/{id}/submit │ ▼ [Credenciamento concluído — order_number gerado]

Text

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

[Autenticação] │ ▼ [Etapa 0] Verificação prévia — documento já possui EC? │ não ▼ [Etapa 1] Criação do merchant (dados mínimos + monthly_card_income) │ └── Retorna: merchant_id + MCC ▼ [Vitrine de Ofertas] ←── Filtragem com MCC e faturamento mensal do merchant │ ▼ [Etapa 1.5] Consulta de CEP + Opções de frete │ ▼ [Etapa 2] Complemento de dados (PUT /merchants) │ ▼ [Etapa 3] Qualificação (análise de risco) │ aprovado ▼ [Etapa 4] Resultado da qualificação confirmado │ ▼ [Etapas 5-6] Montagem dos itens do pedido (offerings → items) │ ▼ [Etapa 7] Informação de dados bancários │ ▼ [Etapa 8] Criação do pedido → POST /orders │ ▼ [Etapa 8.5] Atualização do pedido → PUT /orders/{id} *(quando necessário)* │ ▼ [Etapa 9] Validação do pedido → POST /orders/{id}/validation │ aprovado ▼ [Etapa 10] Submissão do pedido → PUT /orders/{id}/submit │ ▼ [Credenciamento concluído — order_number gerado]

5.2 Detalhamento das etapas

🔐 Autenticação

📄 POST /token

Etapa 0 — Verificação prévia (opcional, mas recomendada)

Idêntica à jornada autônoma.

Text

GET /establishment-contracts-basic/legal-document-number/{cpf_cnpj}/ec-accredited ├── accredited: true ──► Documento já possui EC. Interromper fluxo. └── accredited: false ──► Pode cadastrar. Seguir para Etapa 1.

Text

1

2

3

4

GET /establishment-contracts-basic/legal-document-number/{cpf_cnpj}/ec-accredited ├── accredited: true ──► Documento já possui EC. Interromper fluxo. └── accredited: false ──► Pode cadastrar. Seguir para Etapa 1.

Etapa 1 — Criação do merchant (dados mínimos)

Text

POST /merchants │ Enviar: CPF/CNPJ + dados pessoais básicos + monthly_card_income + opt-ins (LGPD + termos) │ Retorna: merchant_id sub_status_steps (etapas pendentes) economic_activity_profile.merchant_category_code ← MCC │ └──► Guardar o merchant_id e o MCC para usar nas etapas seguintes.

Text

1

2

3

4

5

6

7

8

9

POST /merchants │ Enviar: CPF/CNPJ + dados pessoais básicos + monthly_card_income + opt-ins (LGPD + termos) │ Retorna: merchant_id sub_status_steps (etapas pendentes) economic_activity_profile.merchant_category_code ← MCC │ └──► Guardar o merchant_id e o MCC para usar nas etapas seguintes.

⚠️ Guarde tanto o merchant_id quanto o merchant_category_code — ambos são usados nas chamadas seguintes.

📄 POST /merchants

🛍️ Vitrine de Ofertas (após criação do merchant)

Text

GET /offerings?country=BR&channel={canal}&monthly_card_income={faturamento_mensal}&merchant_category_code={mcc}&fiscal_type={fiscal_type} └── Retorna lista de ofertas (sem taxas de adquirência) GET /offerings?priced_offering_id={id} └── Retorna objeto único com taxas detalhadas por bandeira └─ {id} = priced_offering_id retornado na listagem anterior OU (em uma única chamada) GET /offerings?country=BR&channel={canal}&monthly_card_income={faturamento_mensal}&merchant_category_code={mcc}&fiscal_type={fiscal_type}&show_acquirers=true └── Retorna lista de ofertas já com taxas incluídas

Text

1

2

3

4

5

6

7

8

9

10

11

GET /offerings?country=BR&channel={canal}&monthly_card_income={faturamento_mensal}&merchant_category_code={mcc}&fiscal_type={fiscal_type} └── Retorna lista de ofertas (sem taxas de adquirência) GET /offerings?priced_offering_id={id} └── Retorna objeto único com taxas detalhadas por bandeira └─ {id} = priced_offering_id retornado na listagem anterior OU (em uma única chamada) GET /offerings?country=BR&channel={canal}&monthly_card_income={faturamento_mensal}&merchant_category_code={mcc}&fiscal_type={fiscal_type}&show_acquirers=true └── Retorna lista de ofertas já com taxas incluídas

📄 GET /offerings

Etapas 1.5 a 10 — Complemento, Qualificação, Pedido e Submissão

5.3 Diferenças em relação ao Credenciamento Autônomo

6. Referência Rápida de Endpoints por Etapa

Credenciamento Autônomo

Credenciamento Assistido

7. Conceitos Transversais

merchant_id

priced_offering_id

Identificador de uma oferta com preços detalhados por bandeira. Obtido na Offerings API e utilizado na montagem dos itens do pedido.

order_id e order_number

• order_id: identificador interno gerado no POST /orders. Usado para validação e submissão.
• order_number: gerado após a submissão bem-sucedida. Usado pelo merchant para acompanhar o status logístico do pedido.

Qualificação

Domicílio bancário

Conta(s) bancária(s) onde o merchant receberá os repasses das transações. Deve ser informado por bandeira contratada.

📄 Banks · Centralizers