Overview

The Quote ID system allows you to create and execute financial transactions (deposits and payouts) using pre-generated quotes. This ensures consistent exchange rates and fee calculations between quote generation and transaction execution. The process involves two steps: creating a quote and then executing the transaction.

Base URL: https://api.yativo.com/api/v1

Step 1: Creating a Quote

Endpoint

POST /exchange-rate

Request Parameters

{
    "from_currency": "USD",
    "to_currency": "USD",
    "method_id": 21,
    "method_type": "payout",
    "amount": 406
}

Parameters:

• from_currency (string): Source currency code (e.g., "USD", "EUR", "GBP")
• to_currency (string): Target currency code (e.g., "USD", "EUR", "GBP")
• method_id (integer): Payment method identifier
• method_type (string): Transaction type - either "payout" or "payin" (for deposits)
• amount (number): Amount to convert in the source currency

Response Format

{
    "status": "success",
    "status_code": 200,
    "message": "Request successful",
    "data": {
        "quote_id": "4a72ecf8-6c8a-4e38-9971-8aabe9f785ed",
        "from_currency": "USD",
        "to_currency": "USD",
        "rate": "1.00000000",
        "amount": "406.00000000",
        "converted_amount": "1USD - 1.00000000 USD",
        "payout_data": {
            "total_transaction_fee_in_from_currency": "11.15000000",
            "total_transaction_fee_in_to_currency": "11.15",
            "customer_sent_amount": "406.00",
            "customer_receive_amount": "406.00",
            "customer_total_amount_due": "417.15"
        },
        "calculator": {
            "total_fee": {
                "wallet_currency": 11.15,
                "payout_currency": 11.15,
                "usd": 11.15
            },
            "total_amount": {
                "wallet_currency": 417.15,
                "payout_currency": 417.15
            },
            "amount_due": 417.15,
            "exchange_rate": 1,
            "adjusted_rate": 1,
            "target_currency": "USD",
            "base_currencies": ["USD"],
            "debit_amount": {
                "wallet_currency": 417.15,
                "payout_currency": 417.15
            },
            "customer_receive_amount": {
                "wallet_currency": 406,
                "payout_currency": 406
            },
            "fee_breakdown": {
                "float": {
                    "wallet_currency": 10.15,
                    "payout_currency": 10.15
                },
                "fixed": {
                    "wallet_currency": 1,
                    "payout_currency": 1
                },
                "total": 11.15
            },
            "PayoutMethod": {
                "id": 21,
                "method_name": "PayPal",
                "country": "PER",
                "currency": "USD",
                "payment_method_code": null,
                "cutoff_hrs_start": null,
                "cutoff_hrs_end": null,
                "base_currency": "USD",
                "exchange_rate_float": "0",
                "expiration_time": null
            }
        }
    }
}

Response Fields:

• quote_id: Unique identifier for this specific quote (valid for 5 minutes)
• rate: Exchange rate applied to the transaction
• amount: Original amount requested