Skip to main content
POST
/
api
/
v1.0
/
disbursement
/
{account_id}
/
check-fee
Check fee
curl --request POST \
  --url https://sandbox-payment-b2b.singapay.id/api/v1.0/disbursement/{account_id}/check-fee \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-PARTNER-ID: <api-key>' \
  --data '
{
  "bank_swift_code": "BRINIDJA",
  "amount": 50000
}
'
{
  "status": 200,
  "success": true,
  "data": {
    "gross_amount": "51000.00",
    "transfer_fee": "1000.00",
    "net_amount": "50000.00",
    "currency": "IDR",
    "beneficiary": {
      "full_name": "Bank Rakyat Indonesia",
      "short_name": "BRI"
    }
  }
}

Authorizations

​
Authorization
string
header
required

JWT issued by POST /api/v1.1/access-token/b2b. Send Authorization: Bearer <token>.

​
X-PARTNER-ID
string
header
required

Merchant API key (Credential.api_key). Required on every request.

Path Parameters

​
account_id
string
required

Unique identifier (ULID) of the merchant account that will be debited. Must belong to the authenticated merchant.

Body

application/json

Request body for calculating transfer fee and gross debit before submitting a disbursement.

​
bank_swift_code
string
required

SWIFT or BIC code of the destination bank. Must match a supported bank in the platform bank directory.

Example:

"BRINIDJA"

​
amount
number
required

Net amount to be credited to the beneficiary, in IDR. Must be within merchant-specific minimum and maximum disbursement limits. The quote fails if the gross amount (net plus fee) would exceed the account available balance.

Example:

50000

Response

Success. The data object contains the gross amount, transfer fee, net amount, and destination bank names.

Success response envelope for disbursement check fee endpoint. Contains the fee quote breakdown in data.

​
status
integer

HTTP status code echoed in the response body.

Example:

200

​
success
boolean

Indicates whether the request completed successfully.

Example:

true

​
data
object

Response payload containing the fee quote breakdown.