Revise a due-date collection's value modifiers
Revises the four BACEN value modifiers (fine, interest, abatement, discount) of an ACTIVE due-date collection. Each modifier is an independent RFC 7386 JSON Merge Patch slot: an object present in the body REPLACES that modifier outright, an explicit null REMOVES it, and an absent field leaves the currently-stored modifier unchanged. At least one modifier field is required. No other field (calendar, debtor, key, receiver) is revisable through this endpoint.
Replay: retrying the same request with the same X-Idempotency returns the ORIGINAL 200 response unchanged rather than re-applying the modifiers a second time; retrying the same key with a divergent body is PIX-0031 @ 412. Unlike the other gated mutations, this route is FAIL-CLOSED: if the replay cache cannot serve the request it refuses with PIX-0032 @ 503 instead of re-applying the modifiers without replay protection.
Authorizations
JWT bearer token issued by the identity provider.
Headers
REQUIRED. Client-supplied replay key, at most 64 bytes. A request without it is refused with PIX-0030 @ 400 before the handler runs. Replaying the same key with a divergent method, URL or body is PIX-0031 @ 412.
1 - 64Receiver merchant account UUID
"019606a1-3b4c-7d8e-9f01-234567890abc"
Path Parameters
Collection UUID
"019e22f9-aabe-7ec9-ba6b-41608b9accf9"
Body
Replace (object) or remove (null) the abatement (abatimento) modifier; omit to leave unchanged
Replace (object) or remove (null) the discount (desconto) modifier; omit to leave unchanged
- Option 1
- Option 2
Replace (object) or remove (null) the fine (multa) modifier; omit to leave unchanged
Replace (object) or remove (null) the interest (juros) modifier; omit to leave unchanged
Response
OK
"0196a7b2-3e5f-7061-ac12-34567890abcd"
"100.50"
"2026-05-06T10:30:00Z"
BRL "BRL"
"00020126360014br.gov.bcb.pix2562https://pix.example.com/qr/v2/cobv-abc1235204000053039865802BR5910Loja Teste6007Goiania62070503***63041D3F"
"2026-05-06T11:30:00Z"
"0196a7b2-4f60-7172-bd23-4567890abcde"
"0196a7b2-1c3d-7e4f-8a90-1234567890ab"
false
CPF, CNPJ, PHONE, EMAIL, EVP "EVP"
"123e4567-e12b-12d1-a456-426655440000"
"https://pix.example.com/qr/v2/cobv-abc123"
"Goiania"
"39053344705"
"Loja Teste"
"0196a7b2-2d4e-7f50-9b01-234567890abc"
ACTIVE, COMPLETED, CANCELLED "ACTIVE"
"TX1234567890123456789012345"
IMMEDIATE, DUE_DATE "DUE_DATE"
"2026-05-06T10:30:00Z"
"2026-05-06T10:40:00Z"
"Customer requested cancellation"
"Fatura de servicos"

