Calculate total price

Required permission: cards:read or services:read. Sandbox is isolated from live funds. Live integration availability is checked server-side.

POST /api/v1/quotes

Calculate total price

cURL

curl --request POST \
  --url https://business.planewallet.org/api/v1/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "productId": "virtual-usd",
  "amount": "50.00"
}
'

201

{
  "productId": "<string>",
  "amount": "50.00",
  "fee": "50.00",
  "fixedFee": "50.00",
  "percentageFee": "50.00",
  "rateBps": 20,
  "total": "50.00",
  "currency": "USD",
  "environment": "<string>",
  "priceVersion": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

productId · string · required

Example:

"virtual-usd"

amount · string · required

Pattern: ^\d+(\.\d{1,2})?$

Example:

"50.00"

type · enum<string> · required

Available options: issue, topup, service

Response

201

application/json

Success

productId · string

amount · string

Pattern: ^\d+(\.\d{1,2})?$

Example:

"50.00"

fee · string

Total fee: fixedFee plus percentageFee.

Pattern: ^\d+(\.\d{1,2})?$

Example:

"50.00"

fixedFee · string

Fixed issuance charge; zero for a card top-up.

Pattern: ^\d+(\.\d{1,2})?$

Example:

"50.00"

percentageFee · string

Funding commission rounded up to the nearest cent.

Pattern: ^\d+(\.\d{1,2})?$

Example:

"50.00"

rateBps · integer

Card funding commission in basis points: 20 means 0.2%. Account deposits are charged separately at 150 bps.

Example:

20

total · string

Pattern: ^\d+(\.\d{1,2})?$

Example:

"50.00"

currency · enum<string>

Available options: USD

environment · string

priceVersion · string