Reconcile charge
Admin-only endpoint that marks a charge as paid by its transaction ID, recording the payment timestamp.
Authorizations
JWT bearer token issued by the identity provider.
Body
Transaction identifier of the charge to mark as paid.
"txid-cobv-001"
Response
OK
Original charge amount in BRL as a decimal string, scale 2.
"250.00"
Charge type: COB (immediate), COBV (due-date), or LoteCobV batch item.
"COB"
Creation timestamp in RFC3339 UTC.
"2025-03-07T14:30:00Z"
Server-assigned charge identifier (UUID).
"550e8400-e29b-41d4-a716-446655440000"
Merchant city on the charge.
"São Paulo"
Merchant legal/trade name on the charge.
"Lerian Studio"
Pix key of the receiver settling the charge.
"12345678901"
Charge lifecycle status (ATIVA, CONCLUIDA, REMOVIDA_PELO_USUARIO_RECEBEDOR, REMOVIDA_PELO_PSP).
"ATIVA"
Merchant transaction identifier for the charge.
"txid-cobv-001"
Last-update timestamp in RFC3339 UTC.
"2025-03-07T14:30:00Z"
Configured early-payment discount in BRL as a decimal string, scale 2; empty for none.
"10.00"
Due date for due-date charges (COBV) as an RFC3339 UTC timestamp; null for immediate charges.
"2025-03-15T23:59:59Z"
Immediate-charge (COB) expiry as an RFC3339 UTC timestamp; null when not applicable.
"2025-03-08T23:59:59Z"
Configured monthly interest as a percentage decimal string (e.g. "1.00" = 1%); empty for none.
"1.00"
Settlement timestamp as an RFC3339 UTC timestamp; null until the charge is reconciled as paid.
"2025-03-08T10:15:00Z"
Amount payable at the reference time in BRL, scale 2, after discount/penalty/interest; empty when not computed.
"252.50"
Resolvable payload location URL for the dynamic charge QR (empty when unavailable).
"https://pix.example.com/qr/v2/txid-cobv-001"
Configured late-payment penalty as a percentage decimal string (e.g. "2.00" = 2%); empty for none.
"2.00"
Raw EMV copy-and-paste payload string for the charge (empty when unavailable).
"00020126580014br.gov.bcb.pix..."

