Getting Started
Your comprehensive guide to the Vauchar REST API.
Welcome to the Vauchar API
Welcome! You can use our powerful RESTful API to programmatically access and interact with your Vauchar resources. Our API is designed to be predictable and intuitive, following standard web conventions.
Key architectural features include:
RESTful Design: The API is built on REST principles, providing a structured and logical approach to resource management.
Standard HTTP: We leverage built-in HTTP features and use conventional HTTP response codes to indicate the status of each request.
JSON-Only Responses: All API responses, including errors, are returned in a clean and easy-to-parse JSON format.
Base URL
All URLs referenced in this documentation are relative to the following base URL:
https://api.vauchar.com
Authentication
Vauchar uses API keys to grant access to the API. Your keys control access to all of your merchant data, so be sure to keep them secure!
You can obtain your free API keys by registering on our website:
Register for an API Key: vauchar.com/user/register
Our API uses HTTP Basic Authentication. You must include your Merchant ID and API Key in every request by providing an Authorization
header. The value is a Base64 encoded string of your Merchant_Id:Api_Key
.
Header Format:
Authorization: Basic base64_encoded(<Your_Merchant_Id>:<Your_Api_Key>)
Errors
The Vauchar API uses standard HTTP status codes to indicate the success or failure of a request. Responses with a status code in the 4xx or 5xx range indicate an error.
HTTP Status Code Summary
Code
Description
400
Bad Request – The request was unacceptable, often due to missing a required parameter.
401
Unauthorized – Your Merchant ID or API key is wrong.
402
Insufficient Balance – Your account does not have enough balance to perform the action.
403
Forbidden – You do not have permission to access the requested resource.
404
Not Found – The requested resource could not be found.
405
Method Not Allowed – You tried to access a resource with an invalid HTTP method.
406
Not Acceptable – You requested a response format other than JSON.
500
Internal Server Error – We had a problem with our server. Try again later.
503
Service Unavailable – We're temporarily offline for maintenance. Please try again later.
Last updated