Pay organization's own PIX or BOLEPIX transaction via QR code (Sandbox Only)

Processes a PIX payment using a QR code from a transaction owned by the authenticated organization company, for testing purposes. This endpoint is only available in sandbox environment.

Unlike the merchant variant (/v1/merchants/{merchantId}/transactions/{transactionId}/pay), this endpoint does not require a merchantId parameter. The transaction is looked up using the authenticated organization’s company ID as the transaction owner.

The payer_company_id must be different from the transaction owner (the authenticated company).

Supported payment methods:

• PIX: Uses the QR code from pix_data.qr_code
• BOLEPIX: Uses the PIX EMV code from bolepix_data.pix_emv

POST /v1/transactions/{transactionId}/pay

Pay organization's own PIX or BOLEPIX transaction via QR code (Sandbox Only)

cURL

curl --request POST \
  --url https://api-sandbox.rinne.com.br/core/v1/transactions/{transactionId}/pay \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "payer_company_id": "123e4567-e89b-12d3-a456-426614174002"
}
'

200

{
  "request_id": "f9b978a6-ab7e-4460-997d-1234567890ab",
  "status": "COMPLETED",
  "amount": 10000
}

Authorizations

ApiKeyAuthBearerAuth

x-api-key · string · header · required

Company API key for authentication

Path Parameters

transactionId · string · required

Transaction ID containing the PIX QR code (from pix_data.qr_code for PIX or bolepix_data.pix_emv for BOLEPIX)

Example:

"123e4567-e89b-12d3-a456-426614174001"

Body

application/json

payer_company_id · string · required

ID of the company whose bank account will be used for payment. The payer company must have an active affiliation with the same provider of the transaction to be able to pay. Cannot be the same as the transaction owner company.

Example:

"123e4567-e89b-12d3-a456-426614174002"

Response

200

application/json

Payment processed successfully

request_id · string

Example:

"f9b978a6-ab7e-4460-997d-1234567890ab"

status · enum<string>

Available options: PENDING, PROCESSING, COMPLETED, FAILED

Example:

"COMPLETED"

amount · integer

The transaction's amount in cents (payment is always for the full transaction amount)

Example:

10000