---
title: "Decide o KYB do próprio lojista em sandbox"
method: POST
path: "/v1/_test/merchant/kyb-decision"
tags: ["Sandbox"]
---

# Decide o KYB do próprio lojista em sandbox

`POST /v1/_test/merchant/kyb-decision`

## Request

- Base URL: `https://api.sandbox.mupag.com.br`
- URL: `https://api.sandbox.mupag.com.br/v1/_test/merchant/kyb-decision`
- Auth: HTTP bearer

Helper autenticado disponível somente quando o customer-service sobe com perfil local, sandbox ou test.
A rota não existe no ambiente `prd`, nem com perfil vazio ou desconhecido. O lojista é o da API key;
identificador do lojista no corpo é opcional e rejeitado quando diverge. Gera a mesma auditoria de outbox da decisão
de KYB do backoffice, com environment=sandbox. documents_pending permanece no go-live e sai no evento
como requires_additional_info, estado não elegível aceito pelo contrato.

## Headers

- `Idempotency-Key` string, required

## Request body

- SandboxMerchantKybDecisionRequest
  - `decision` 'approved' | 'rejected' | 'documents_pending', required
  - `merchant_id` string, uuid: Opcional. Se enviado, precisa ser o lojista da API key; divergência é rejeitada.
  - `reason` string

## Response `200`

KYB do lojista autenticado aplicado ou resposta original retornada.

- SandboxMerchantKybDecisionResponse
  - `merchant_id` string, uuid, required
  - `environment` 'sandbox', required
  - `decision` 'approved' | 'rejected' | 'documents_pending', required
  - `merchant_status` string, required
  - `go_live_status` string, required
  - `kyc_status` string, required: Valor publicado no evento. documents_pending vira requires_additional_info.
  - `financial_eligibility_version` integer, required

## Other responses

- `400`: Idempotency-Key ausente, curta demais ou com caractere invalido. A borda responde `idempotency_key_required` ou `idempotency_key_invalid`.
- `401`: Falha de autenticação
- `403`: Permissão insuficiente
- `404`: Recurso não encontrado
- `409`: Conflito de idempotência ou estado
- `422`: Erro de validação

---

[API](https://skmtc.dev/mupag/apis/mupag-public-merchant-api.md) · [All operations](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/revisions/677904516d2d?raw)