Skip to main content
POST
/
v1
/
quote
Create Quote
const url = 'https://sandboxapi.me-cash.com/v1/quote';
const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: '{"paymentChannel":"BANK_TRANSFER","source":{"amount":150000,"country":"NG","currency":"NGN"},"target":{"country":"NG","currency":"NGN"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
{
  "message": "quote successfully created",
  "status": "success",
  "data": {
    "id": "e5eec724-38f9-40e2-9i86-xxxxxxxxxxxxx",
    "source": {
      "currency": "NGN",
      "country": "NG",
      "amount": 150000
    },
    "target": {
      "currency": "USD",
      "country": "US",
      "amount": 81.97
    },
    "rate": 1830,
    "fee": {
      "amount": 0
    },
    "rules": [
      {
        "category": "LIMIT",
        "appliedCurrency": "USD",
        "appliedCountry": "US",
        "transaction": {
          "minimum": 1,
          "maximum": 20000000000000
        },
        "invoice": 200000000000
      }
    ],
    "summary": {
      "total": 150000
    },
    "settlementTime": "1 hr",
    "quoteCurrency": "USD",
    "expiresInSeconds": 600
  }
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Details for the new quote.

​
paymentChannel
enum<string>
required

The channel through which the payment will be processed.

Available options:
BANK_TRANSFER,
INTERAC
Example:

"BANK_TRANSFER"

​
source
object
required
​
target
object
required

Response

Quote created successfully.

​
message
string
Example:

"quote successfully created"

​
status
string
Example:

"success"

​
data
object
⌘I