{"_id":"593fe2262418a7003933a36b","category":{"_id":"593fe2262418a7003933a360","version":"593fe2262418a7003933a35e","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-01T16:42:25.324Z","from_sync":false,"order":1,"slug":"payment-api-essentials","title":"API Usage"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"593fe2262418a7003933a35e","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-06-13T13:01:26.536Z","releaseDate":"2017-06-13T13:01:26.536Z","categories":["593fe2262418a7003933a35f","593fe2262418a7003933a360","593fe2262418a7003933a361","593fe2262418a7003933a362","593fe2262418a7003933a363","593fe2262418a7003933a364","593fe2262418a7003933a365"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"3.21.2","version_clean":"8976.0.0-Basics","version":"8976-Basics"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-10-06T17:30:48.697Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"The BlueSnap APIs are a collection of RESTful based web services. They use standard HTTP features, such as HTTP verbs and Basic authentication, and can be used easily with any HTTP client.\n\n###API URLs\nTo interact with the APIs, you will send an authenticated HTTP request to an API URL. Each API URL defines a requested environment, resource type, and an action to perform. For example, this is the API URL you would use to create a new transaction in the sandbox environment:\n\n`POST https://sandbox.bluesnap.com/services/2/transactions`\n\n###Request and response format\nEach request should include Basic authentication and specify the relevant content type. See [Authentication & headers](doc:authentication).\n\nRequests may also include body content where necessary.\n\nThe API requests and responses are formatted as either JSON or XML.\n\nTo download BlueSnap's XSD schema files, go to:\n  * **Payment API**: [https://github.com/bluesnap/payment-api-resources](https://github.com/bluesnap/payment-api-resources)\n  * **Extended Payment API**: [https://github.com/bluesnap/api-resources](https://github.com/bluesnap/api-resources)\n\n###Errors\nHTTP status codes are sent back in the API responses to indicate whether a request was successful. In case of an error, the response body contains an error message with a more detailed description of the error.","excerpt":"","slug":"about","type":"basic","title":"About the BlueSnap APIs"}

About the BlueSnap APIs


The BlueSnap APIs are a collection of RESTful based web services. They use standard HTTP features, such as HTTP verbs and Basic authentication, and can be used easily with any HTTP client.

API URLs

To interact with the APIs, you will send an authenticated HTTP request to an API URL. Each API URL defines a requested environment, resource type, and an action to perform. For example, this is the API URL you would use to create a new transaction in the sandbox environment:

POST https://sandbox.bluesnap.com/services/2/transactions

Request and response format

Each request should include Basic authentication and specify the relevant content type. See Authentication & headers.

Requests may also include body content where necessary.

The API requests and responses are formatted as either JSON or XML.

To download BlueSnap's XSD schema files, go to:

Errors

HTTP status codes are sent back in the API responses to indicate whether a request was successful. In case of an error, the response body contains an error message with a more detailed description of the error.