Add balance to organization bank account (Sandbox Only)

Adds balance to the authenticated organization’s own bank account for testing purposes. This endpoint is only available in sandbox environment.

Unlike the merchant variant (/v1/merchants/{merchantId}/balance), this endpoint does not require a merchantId parameter. The organization is identified from the authenticated user’s company ID, which must be of type ORGANIZATION.

POST /v1/banking/balance

Add balance to organization bank account (Sandbox Only)

cURL

curl --request POST \
  --url https://api-sandbox.rinne.com.br/core/v1/banking/balance \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "amount": 10000,
  "provider": "CELCOIN"
}
'

200

{
  "status": "CONFIRMED",
  "request_id": "f9b978a6-ab7e-4460-997d-1234567890ab"
}

Authorizations

ApiKeyAuthBearerAuth

x-api-key · string · header · required

Company API key for authentication

Body

application/json

amount · integer · required

Amount to add in cents

Required range: x >= 1

Example:

10000

provider · string · default: CELCOIN

Banking provider (defaults to CELCOIN. Accepts lowercase and uppercase)

Example:

"CELCOIN"

Response

200

application/json

Balance added successfully

status · enum<string>

Available options: PROCESSING, CONFIRMED, ERROR

Example:

"CONFIRMED"

request_id · string

Example:

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