SonaCORE

Referência / Quadra Core API

Pix

9 operações em Quadra Core API 0.5.0.

GET/v1/pix/keys

List Pix keys for an account

List the account's sponsor-registered DICT keys (GSI1 ACCOUNT_PIXKEY# rows). Writes live on command-api (POST /v1/pix/keys).

Parâmetros

NomeTipoDetalhe
account_idstringqueryobrigatório
limitintegerquery
cursorstring, opcionalquery

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação
GET/v1/pix/keys/{key_id}

Get a Pix key with its claims

Get a single Pix key registry row plus its claim history (each claim carries the read-side `expired` flag) and the key's state_history.

Parâmetros

NomeTipoDetalhe
key_idstringpathobrigatório

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação
GET/v1/pix/mandates

List Pix Automático mandates

List mandates — per-account via the MANDACCT# direct-PK rows, or globally via the sparse GSI9 MANDATE_ALL listing (newest first).

Scoped to the calling tenant; an `account_id` belonging to another tenant reads as not found. **Page until `next_cursor` is null** — a short page is not the end of the list.

Parâmetros

NomeTipoDetalhe
account_idstring, opcionalquery Filter to one account
statusstring, opcionalquery Filter by mandate status
limitintegerquery
cursorstring, opcionalquery

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação
GET/v1/pix/mandates/{mandate_id}

Get a Pix Automático mandate with its charges

Parâmetros

NomeTipoDetalhe
mandate_idstringpathobrigatório

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação
GET/v1/pix/med/cases

List MED cases

List MED cases newest-first (operations-table GSI1 listing — low-cardinality admin query). Filters apply in-memory per page (the hold-views posture), so a filtered page may return fewer than ``limit`` items while ``next_cursor`` still advances.

Parâmetros

NomeTipoDetalhe
statusstring, opcionalquery Filter by case state
account_idstring, opcionalquery Filter by suspect account
limitintegerquery
cursorstring, opcionalquery

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação
GET/v1/pix/med/cases/{case_id}

Get a MED case

Get a single MED case with its full history[].

Parâmetros

NomeTipoDetalhe
case_idstringpathobrigatório

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação
GET/v1/pix/qr/{account_id}/static

Generate a static Pix QR (BR Code) for an account

Generate a reusable static BR Code entirely locally (LaaS-15 D5): a pure read of the account's ACTIVE Ticket-14 key + owner party -> the shared/brcode.py codec. Stateless — no PIXQR# row, no status. key_id is defaulted when the account has exactly one ACTIVE key (else 422).

Parâmetros

NomeTipoDetalhe
account_idstringpathobrigatório
key_idstring, opcionalquery
amount_centsinteger, opcionalquery
descriptionstring, opcionalquery
txidstring, opcionalquery

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação
GET/v1/pix/qr/charges

List dynamic Pix QR charges for an account

List the account's PIXQR# charge rows (GSI1 ACCOUNT_PIXQR# rows). Writes live on command-api (POST /v1/pix/qr/{account_id}/dynamic).

Parâmetros

NomeTipoDetalhe
account_idstringqueryobrigatório
limitintegerquery
cursorstring, opcionalquery

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação
GET/v1/pix/qr/charges/{txid}

Get a dynamic Pix QR charge

Read one PIXQR# charge row (pure DynamoDB — the polling surface the guest settle flow consumes). Computes the read-side `expired` flag.

Parâmetros

NomeTipoDetalhe
txidstringpathobrigatório

Respostas

StatusCorpoDetalhe
200Resposta bem-sucedidaO contrato não declara um modelo para esta resposta, então a forma dela não está documentada aqui. Um roteiro de demonstração mostra a forma que ela realmente devolve.
422HTTPValidationErrorErro de validação

Esquemas

Os modelos que as operações acima aceitam e devolvem. Campos opcionais estão marcados como tal; um campo tipado como outro modelo está documentado sob o nome dele.

HTTPValidationError

CampoTipoDetalhe
detailarray de ValidationError

ValidationError

CampoTipoDetalhe
ctxobject
inputnão declarado
locarray de string ou integerobrigatório
msgstringobrigatório
typestringobrigatório