Fees

Read and set the fees you charge your customers on top of Depa's contractual rates, and estimate blockchain network fees.

Your contract sets a minimum fee per service. Anything you configure above it is your markup and is credited to your collections account. Percentages are decimal fractions: 0.01 is 1%.

For markups on more rails (SWIFT, ACH, Fedwire, FPS, CHAPS), with defaults at vault level, use Vendor Fees.

Retrieve the trading fee

GET/accounts/{account_id}/trading_fees

Returns the trading fee charged to the account, as a decimal fraction (0.005 is 0.5%).

Authorization

BearerAuth

AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Path Parameters

account_id*string

ID of the account.

Formatuuid

`application/json`

curl -X GET "https://example.com/accounts/8f3a2c1e-5b7d-4e9a-9c21-7d4b6e0f1a23/trading_fees"

{  "data": {    "name": "trading_fee",    "enabled": true,    "configuration": 0.005  }}

Set the trading fee

PUT/accounts/{account_id}/trading_fees

Sets the trading fee charged to the account, as a decimal fraction: 0.01 is 1%. Anything above your contractual minimum is credited to your collections account. Fees below the minimum, or above 100%, return 422.

Authorization

BearerAuth

AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Path Parameters

account_id*string

ID of the account.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

trading_fee*number

Trading fee as a decimal fraction (0.01 is 1%).

Response Body

`application/json`

curl -X PUT "https://example.com/accounts/8f3a2c1e-5b7d-4e9a-9c21-7d4b6e0f1a23/trading_fees" \  -H "Content-Type: application/json" \  -d '{    "trading_fee": 0.01  }'

{  "data": {    "name": "trading_fee",    "enabled": true,    "configuration": 0.01  }}

Retrieve the SEPA fee

GET/accounts/{account_id}/sepa_fees

Returns the SEPA transfer fee charged to the account, a fixed amount plus a percentage of each payment.

Authorization

BearerAuth

AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Path Parameters

account_id*string

ID of the account.

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.com/accounts/8f3a2c1e-5b7d-4e9a-9c21-7d4b6e0f1a23/sepa_fees"

{  "data": {    "fixed": 1,    "percentage": 0.002  }}

Set the SEPA fee

PUT/accounts/{account_id}/sepa_fees

Sets the SEPA transfer fee charged to the account: fixed per payment plus percentage of its amount, as a decimal fraction (0.01 is 1%). Anything above your contractual minimum is credited to your collections account. Fees below the minimum return 422.

Authorization

BearerAuth

AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Path Parameters

account_id*string

ID of the account.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

sepa_fee*

Response Body

`application/json`

curl -X PUT "https://example.com/accounts/8f3a2c1e-5b7d-4e9a-9c21-7d4b6e0f1a23/sepa_fees" \  -H "Content-Type: application/json" \  -d '{    "sepa_fee": {      "percentage": 0.002,      "fixed": 1    }  }'

{  "data": {    "name": "sepa_fee",    "enabled": true,    "configuration": {      "fixed": 1,      "percentage": 0.002    }  }}

Retrieve a wallet's network fee

GET/accounts/{account_id}/blockchain_wallets/{id}/fees

Returns the network fee for a payment from this wallet, in the wallet's asset.

Authorization

BearerAuth

AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Path Parameters

account_id*string

ID of the account.

Formatuuid

id*string

ID of the blockchain wallet.

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.com/accounts/8f3a2c1e-5b7d-4e9a-9c21-7d4b6e0f1a23/blockchain_wallets/9a7b3c2d-1e4f-4a6b-8c9d-0e1f2a3b4c5d/fees"

{  "data": {    "network": "POLYGON",    "fees": 0.05  }}

Estimate a network fee

GET/gas_fees

Returns the estimated network fee of a blockchain payment for an asset and network, before you create it.

Authorization

BearerAuth

AuthorizationBearer <token>

Token from POST /sign_in, sent as Authorization: Bearer <token>.

In: header

Query Parameters

blockchain*string

Blockchain network.

Value in

"polygon"
"bitcoin"
"ethereum"
"tron"

asset*string

Asset to send.

Response Body

`application/json`

curl -X GET "https://example.com/gas_fees?blockchain=polygon&asset=USDC"

{  "fees": 0.05,  "asset": "USDC",  "network": "polygon"}

Retrieve the trading feeCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

404application/json

Set the trading feeCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

404application/json

422application/json

Retrieve the SEPA feeCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

404application/json

Set the SEPA feeCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

404application/json

422application/json

Retrieve a wallet's network feeCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

404application/json

Estimate a network feeCopy Anchor Link

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

401application/json

Retrieve the trading fee

Authorization

Path Parameters

Response Body

`application/json`

`application/json`

`application/json`

Set the trading fee

Authorization

Path Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

Retrieve the SEPA fee

Authorization

Path Parameters

Response Body

`application/json`

`application/json`

`application/json`

Set the SEPA fee

Authorization

Path Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

Retrieve a wallet's network fee

Authorization

Path Parameters

Response Body

`application/json`

`application/json`

`application/json`

Estimate a network fee

Authorization

Query Parameters

Response Body

`application/json`

`application/json`