Skip to main content
POST
/
v1
/
merchants
/
{merchantId}
/
balance
Add balance to merchant bank account (Sandbox Only)
curl --request POST \
  --url https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/balance \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "amount": 10000,
  "provider": "CELCOIN"
}
'
{
  "status": "CONFIRMED",
  "request_id": "f9b978a6-ab7e-4460-997d-1234567890ab"
}

Authorizations

​
x-api-key
string
header
required

Company API key for authentication

Path Parameters

​
merchantId
string
required

Merchant/Company ID

Example:

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

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

Balance added successfully

​
status
enum<string>
Available options:
PROCESSING,
CONFIRMED,
ERROR
Example:

"CONFIRMED"

​
request_id
string
Example:

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