NoviuzNoviuz Docs
API NexiuzTry API

Criar cobrança PIX

POST/api/public/v1/pix

Cria uma cobrança PIX. code identifica a intenção e deve ser mantido no retry.

Required application scope: pix:write.

Authorization

BearerAuth RequestSignature
AuthorizationBearer <token>

In: header

X-Signature<token>

HMAC-SHA256 calculado com signing_secret sobre timestamp.nonce.METHOD.path.sha256(body). O Try API não recebe nem armazena o segredo: calcule a assinatura no seu ambiente e cole o valor aqui.

In: header

Header Parameters

X-Timestamp*string

Timestamp Unix em segundos.

Match^[0-9]{1,12}$
X-Nonce*string

Nonce único por requisição (16–128 caracteres).

Match^[A-Za-z0-9_-]{16,128}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Corpo do POST /pix (spec F2 §5). O code é a idempotência (D11).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/public/v1/pix" \  -H "X-Timestamp: string" \  -H "X-Nonce: string" \  -H "Content-Type: application/json" \  -d '{    "code": "string",    "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",    "amount": "string",    "payer_document": "string"  }'
{  "id": "string",  "code": "string",  "status": "string",  "environment": "string",  "account_id": "string",  "amount": "string",  "asset_code": "string",  "qr_code": "string",  "qr_code_base64": "string",  "expires_at": "string",  "fees": {    "provider_fee": "string",    "partner_fee": "string",    "net_amount": "string"  },  "payer_name": "string",  "payer_document": "string",  "metadata": {    "property1": "string",    "property2": "string"  },  "created_at": "string"}