SDKs

SDKs and libraries

MAXFI does not publish server SDK packages. Your server calls the REST API over HTTPS with any HTTP client. In the browser you use the Widget SDK (maxfi.js).

REST API

Base URL — https://maxfi-api.exezine.az
Authentication — your secret key in the Authorization header: Bearer sk_test_… or sk_live_…. The X-API-Key header is also accepted.
Code samples — cURL, Node.js, Python, PHP and Go on the documentation and API reference pages. They use plain HTTP requests and need no extra packages.
Specification — OpenAPI 3.1 in JSON, Markdown and PDF. The JSON file can be imported into Postman. Download the specification

Widget SDK (maxfi.js)

A browser library that opens the MAXFI payment page in a frame on your site. Current version: 3.

Load it from the MAXFI API host and pass your publishable key (pk_test_… or pk_live_…). Your server creates the payment session with your secret key and passes its id to the page. Never put a secret key in a web page: the SDK refuses it.

<script src="https://maxfi-api.exezine.az/widget/v1/maxfi.js"></script>
<script>
  const maxfi = new Maxfi('pk_test_…');
  // sessionId comes from your server: POST /widget/v1/session
  maxfi.openCheckout({ sessionId: 'cs_…' });
</script>

Widget SDK guide

New to MAXFI? Start with the Quickstart.