Skip to main content
PUT
/
v1
/
collections
/
immediate
/
{collection_id}
Update an Immediate Charge
curl --request PUT \
  --url https://plugin-pix-indirect.api.lerian.net/v1/collections/immediate/{collection_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Account-Id: <x-account-id>' \
  --data '
{
  "additionalInfo": {
    "status": "updated",
    "version": "2"
  },
  "amount": "150.00",
  "debtorDocument": "98765432109",
  "debtorName": "Maria Santos",
  "description": "Updated payment description",
  "expirationSeconds": 7200,
  "metadata": {},
  "receiverKey": "+5511988888888",
  "tags": [
    "updated",
    "revised"
  ]
}
'
{
  "additionalInfo": {
    "customerId": "67890",
    "orderId": "12345"
  },
  "amount": "100.00",
  "createdAt": "2024-01-15T10:30:00Z",
  "debtorDocument": "12345678901",
  "debtorName": "João da Silva",
  "description": "Payment for order #12345",
  "emv": "00020126580014br.gov.bcb.pix...",
  "expirationSeconds": 3600,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "locationUrl": "https://api.example.com/qr/550e8400",
  "metadata": {},
  "receiverKey": "+5511999999999",
  "status": "ACTIVE",
  "tags": [
    "ecommerce",
    "subscription"
  ],
  "txId": "TXN123456789",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Account-Id
string
required

Account ID (UUID format)

Path Parameters

​
collection_id
string
required

Identifier of the immediate collection

Body

application/json
​
additionalInfo
object

AdditionalInfo is the new key-value map for additional information

Example:
{ "status": "updated", "version": "2" }
​
amount
string

Amount is the new collection amount in decimal format with 2 decimal places

Example:

"150.00"

​
debtorDocument
string

DebtorDocument is the new CPF or CNPJ of the payer (must be provided with DebtorName)

Example:

"98765432109"

​
debtorName
string

DebtorName is the new name of the payer (must be provided with DebtorDocument)

Example:

"Maria Santos"

​
description
string

Description is the new custom description for the collection

Example:

"Updated payment description"

​
expirationSeconds
integer

ExpirationSeconds is the new expiration time in seconds (must be greater than 0)

Example:

7200

​
metadata
object

Metadata is a map for updating custom key-value pairs (RFC 7386 merge patch)

​
receiverKey
string

New Pix key that will receive the payment

Minimum string length: 1
Example:

"+5511988888888"

​
tags
string[]

Tags is the new array of custom tags

Example:
["updated", "revised"]

Response

Collection updated successfully

​
additionalInfo
object

AdditionalInfo contains additional key-value information

Example:
{ "customerId": "67890", "orderId": "12345" }
​
amount
string

Amount is the collection amount in decimal format

Example:

"100.00"

​
createdAt
string

CreatedAt is the timestamp when the collection was created

Example:

"2024-01-15T10:30:00Z"

​
debtorDocument
string

DebtorDocument is the CPF or CNPJ of the payer

Example:

"12345678901"

​
debtorName
string

DebtorName is the name of the payer

Example:

"João da Silva"

​
description
string

Description is the custom description of the collection

Example:

"Payment for order #12345"

​
emv
string

EMV is the QR code payload in EMV format

Example:

"00020126580014br.gov.bcb.pix..."

​
expirationSeconds
integer

ExpirationSeconds is the time in seconds until expiration

Example:

3600

​
id
string

ID is the unique identifier of the collection

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
locationUrl
string

LocationURL is the URL to access the collection location/QR code

Example:

"https://api.example.com/qr/550e8400"

​
metadata
object

Metadata is the custom metadata associated with this collection

​
receiverKey
string

Pix key that will receive the payment

Example:

"+5511999999999"

​
status
string

Status is the current status of the collection

Example:

"ACTIVE"

​
tags
string[]

Tags is an array of custom tags

Example:
["ecommerce", "subscription"]
​
txId
string

TxID is the transaction identifier

Example:

"TXN123456789"

​
updatedAt
string

UpdatedAt is the timestamp of the last update

Example:

"2024-01-15T10:30:00Z"