Decide KYB for the authenticated merchant in sandbox
POST/v1/_test/merchant/kyb-decision
This authenticated helper is available only when customer-service starts with the local, sandbox, or test profile.
The route does not exist in the prd environment, nor with an empty or unknown profile. The merchant is the one from the API key;
merchant_id in the body is optional and rejected when it diverges. It emits the same outbox audit as the backoffice KYB decision,
with environment=sandbox. documents_pending remains in go-live and is published on the event
as requires_additional_info, a non-eligible state accepted by the contract.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
Authenticated merchant KYB applied or original response returned.
Missing Idempotency-Key, key too short, or invalid character.
The edge responds with idempotency_key_required or idempotency_key_invalid.
Authentication failed
Insufficient permission
Resource not found
Idempotency or state conflict
Validation error
Did this page unblock the next step?
Feedback stays inside the docs flow and should never include customer or card data.