RIripple
Fees

Get fee by ID

Gets a fee by ID.

get/config/fees/{id}

Request

Path parameters

idstring uuid required

Provide the feeId of the fee you want to retrieve.

Response

Successfully retrieved fee.

valuenumber required

Value of the fee to be applied. fiat node uses this value and fee_type to calculate the fee.

currency_codestring required

Currency this fee applies to.

role_type'SENDING' | 'RECEIVING' | 'INSTITUTION_SENDING' | 'INSTITUTION_RECEIVING' required

Role of the party to which the fee applies.<p>If set to SENDING, the fee is charged to the originator of the payment.</p> <p>If set to RECEIVING, the fee is charged to the beneficiary of the payment.</p> <p>If set to INSTITUTION_SENDING, the fee is charged to the financial institution that is sending the payment.</p> <p>If set to INSTITUTION_RECEIVING, the fee is charged to the financial institution that is receiving the payment.</p>

payment_type'REGULAR' | 'RETURN' required

Payment type the fee applies to.

node_type'INITIAL' | 'INTERMEDIATE' | 'TERMINAL' required

Fiat node to which the fee applies.<p>If set to INITIAL, the fee is charged to the first fiat instance in the payment chain.</p> <p>If set to INTERMEDIATE, the fee is charged to each fiat instance in the payment chain that is not the first or last fiat instance.</p> <p>If set to TERMINAL, the fee is charged to the last fiat instance in the payment chain.</p>

fee_type'PERCENTAGE' | 'FLAT_RATE' required

Method used to calculate the fee.

partner_namestring

Owner of the account involved in the payment, in RippleNet Address format. For example, rn.us.ca.san_francisco.

account_namestring

For a fee that applies to a specific account, provides the account name. Used in combination with the partner_name value.

upper_limitnumber

For a slab-based fee, provides the upper limit of the slab. Used in combination with the lower_limit value.

lower_limitnumber

For a slab-based fee, provides the lower limit of the slab. Used in combination wtih the upper_limit value.

feeIdstring uuid required

Unique identifier of the fee.

payout_methodstring

The payout method for this fee.

fee_category'NONE' | 'OVERSEAS_DELIVERY_CHARGES' | 'BENEFICIARY_BANK_CHARGE' | 'PROCESSING_HANDLING_CHARGE' | 'LOCAL_GOVERNMENT_CHARGE' | 'OTHER'

Category that describes the purpose of the fee.

fee_descriptionstring

Optional free-form description for the fee.

Example response

{
  "value": 2,
  "currency_code": "USD",
  "role_type": "SENDING",
  "payment_type": "REGULAR",
  "node_type": "INITIAL",
  "fee_type": "FLAT_RATE",
  "partner_name": "rn.us.ca.san_francisco",
  "account_name": "conct_usd_sf",
  "upper_limit": 1000,
  "feeId": "7740f31c-ca03-4414-b491-b285aef71eb1",
  "payout_method": "LOCAL_RAILS",
  "fee_category": "BENEFICIARY_BANK_CHARGE"
}

Changes

No recorded changes to this operation across all 1 revision of this API.