Skip to main content
POST
Create a CobV (due-date) composite Pix Automático QR code

Authorizations

Authorization
string
header
required

JWT Bearer token authentication. Obtain token from /v1/login/oauth/access_token endpoint using client credentials (clientId and clientSecret).

Include token in Authorization header: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token expires after 3600 seconds (1 hour).

Body

application/json
accountId
string
required

The CRM account id of the recipient (sources name + city).

daysAfterDue
integer<int64>
required

Days after the due date the charge can still be paid (diasAposVenc).

dueDate
string
required

Due date for payment (dtVenc; aaaa-mm-dd).

finalAmount
number<double>
required

Final charge amount in reais (valorFinal, after adjustments).

jwkUrl
string
required

JWK Set URL (urlJwk; no scheme).

key
string
required

The recipient Pix key the composite QR pays into.

paymentPayloadUrl
string
required

CobV JWS host URL (urlPayloadJson; no scheme).

recipientStreet
string
required

Recipient street (logradouroRecebedor).

recurrence
object
required
recurrencePayloadUrl
string
required

Recurrence JWS host URL (urlPayloadJsonRec; no scheme).

state
string
required

Recipient state (uf).

txId
string
required

Conciliation id (idConciliacaoRecebedor).

zipCode
string
required

Recipient postal code (cep).

certificateIspb
string

Indirect-PSP certificate ISPB (ispbCertificadoJws, string).

description
object[] | null

Optional additional-data entries (dadosAdicionais).

discount
number<double>

Discount in reais (desconto; omit/0 to skip).

fine
number<double>

Fine in reais (multa; omit/0 to skip).

interest
number<double>

Interest in reais (juros; omit/0 to skip).

originalAmount
number<double>

Original charge amount in reais (valorOriginal, before adjustments).

payer
object
rebate
number<double>

Rebate in reais (abatimento; omit/0 to skip).

Response

Created

qrCode
string
required

The generated EMV composite-QR payload (base64-decoded, ready to render).

documentId
string

The recurrence/charge document id (idDocumento, GUID).

recurrencePayload
string

The signed recurrence JWS (payloadJwsRecorrencia).