Get Quotes

GET 
/api/crypto-purchase/v2/quotes

Generates basic quote for the end customer based on partner's default fees configuration upon the provided parameters - source and destination currency, preferred payment method, etc.

Request

Query Parameters

sourceCurrency stringrequired
The source currency in which the customer wants to make the payment for the crypto
Example: USD
sourceAmount numberrequired
The source amount the customer wants to spend to purchase crypto
Example: 100
destinationCurrency stringrequired
The destination currency the customer wants to purchase
Example: BTC
network stringrequired
Name of the network that is being used to calculate the quote
Example: Mainnet
paymentMethod string
The payment method the customer wants to use for the payment
Example: CARD
countryId string
The ISO-3 code of the customer's country
Example: BGR

Responses

200

OK

application/json

Schema

Schema

sourceDetails

object

Source details - amount, currency and payment method

amount number

Source amount used for buying crypto

currency string

Source currency used for buying crypto

paymentMethod PaymentMethod (string)

Possible values: [CARD, BALANCE]

The payment method used by the customer

destinationDetails

object

Destination asset details - amount, cryptocurrency, network processing the transaction

amount numberrequired

The amount of the purchased cryptocurrency

currency stringrequired

The cryptocurrency the customers wants to purchase

network stringrequired

The network of the cryptocurrency

sourceToDestinationRate number

How much does one unit in source currency cost in destination currency

destinationToSourceRate number

How much does one unit in destination currency cost in source currency

fees

object[]

Contains details on the fees for the payment - type, amount and currency of the fee

Array [

type string

Possible values: [TRANSACTION, PARTNER, FX, NETWORK]

Fee type:

• FX - Applies when customer's fiat currency is not EUR
• NETWORK - Goes to a blockchain network for transferring a digital asset on that network
• TRANSACTION - Fee charged by Paysafe for the Transaction
• PARTNER - Fee charged on top of the Transaction and FX fee, shared with the Skrill Referral Partner

amount number

Fee amount

currency string

Fee currency

]

totalSpend number

Total amount spent without taxes

totalSpendCurrency string

Final total spend currency

Example (from schema)

{
  "sourceDetails": {
    "amount": 100,
    "currency": "USD",
    "paymentMethod": "CARD"
  },
  "destinationDetails": {
    "amount": 0.00576545,
    "currency": "BTC",
    "network": "Mainnet"
  },
  "sourceToDestinationRate": 0.0000612,
  "destinationToSourceRate": 15849.658299521701,
  "fees": [
    {
      "value": [
        {
          "type": "FX",
          "amount": 4.13,
          "currency": "USD"
        },
        {
          "type": "TRANSACTION",
          "amount": 1.9,
          "currency": "USD"
        },
        {
          "type": "PARTNER",
          "amount": 2.5,
          "currency": "USD"
        },
        {
          "type": "NETWORK",
          "amount": 5.06,
          "currency": "USD"
        }
      ]
    }
  ],
  "totalSpend": 91.47,
  "totalSpendCurrency": "USD"
}

quotes

{
  "sourceDetails": {
    "amount": 100,
    "currency": "USD",
    "paymentMethod": "CARD"
  },
  "destinationDetails": {
    "amount": 0.00576545,
    "currency": "BTC",
    "network": "Mainnet"
  },
  "sourceToDestinationRate": 0.0000612,
  "destinationToSourceRate": 15849.658299521701,
  "fees": [
    {
      "type": "FX",
      "amount": 4.13,
      "currency": "USD"
    },
    {
      "type": "TRANSACTION",
      "amount": 1.9,
      "currency": "USD"
    },
    {
      "type": "PARTNER",
      "amount": 2.5,
      "currency": "USD"
    },
    {
      "type": "NETWORK",
      "amount": 5.06,
      "currency": "USD"
    }
  ],
  "totalSpend": 91.47,
  "totalSpendCurrency": "USD"
}

400

Bad Request

application/json

Schema

Schema

code string

Error code

message string

Error message

Example (from schema)

{
  "code": "Invalid source currency",
  "description": "The source currency code is invalid, or your account does not support this currency."
}

401

Unauthorized

application/json

Schema

Schema

error

object

Additional details about an error

code string

The error code.

message string

A description of the error.

details string[]

Details of any parameter value errors.

fieldErrors

object[]

Array [

field string

Identifies the JSON request field.

error string

The problem associated with the field.

]

Example (from schema)

{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      "string"
    ],
    "fieldErrors": [
      {
        "field": "string",
        "error": "string"
      }
    ]
  }
}

unauthorized

{
  "error": null,
  "code": 5279,
  "message": "Invalid credentials",
  "details": [
    "The authentication credentials are invalid."
  ]
}

500

General Error

application/json

Schema

Schema

any

general-error

{
  "error": {
    "code": "General Error",
    "message": "Something went wrong.",
    "details": [
      {
        "General Error, additional details": "..."
      }
    ]
  }
}

Loading...