Getting Started
HTTPS
The FeatherPay APIs will only accept HTTPS traffic.
REST / JSON
API - FeatherPay APIs are RESTful JSON apis. Â
Environments
There are 2 API environments. Each environment has separate databases and their own keys.
You can also login to our UI interface for creating and seeing the status of invoices, the same way a merchant may do:
The staging/sandbox environment is more volatile, but also more up-to-date. Where the above production environment is updated every 2 weeks, this environment is updated as soon as development / code review is completed. You can also use our Swagger tool (mentioned below) to gain valuable testing insights into our APIs.
Keys
There are 3 store-wide, 52 alphanumeric character api keys per environment per store (location).Â
- A public key, which is sharable with front-end applications for embedding patient-facing payments iFrame
- A merchant public key, whic is shareable with front-end applications for embedding merchant-facing payments iFrame
- A private key, which is used for our API calls. This should be only stored and used on your server.
All APIs can be called from your backend using your private key. Some APIs can be called from the front end using a combination of your public key and an order specific order key. The order key is used to securely carry out operations from your front end, and should not be stored, logged, put in a url, or exposed to anyone besides the customer.
Ids
All ids in our system are 26 alphanumeric character ULIDs (see https://github.com/ulid/spec). Your store id will be provided.
X-Store-Id
All REST API calls should be made with a HTTP header key of X-Store-Id and the value being the 26 alphanumeric character ULID that is given to you with the keys
Amounts
Amounts are all in US dollars and cents, multiplied by 100, resulting in an integer. So $500.00 would be represented as 50000.
Errors
There may be varying statuses based on the error of the request, but all error messages will return a field message with the error message
Comments
In the following API documentation, a few cURL commands have comments by a field to better explain the use of that parameter / field. As this is not valid JSON, please make sure to remove these comments before running the cURL command.
Staging Environment (Optional)
There is a 3rd Staging environment, which is more volatile, but also more up-to-date. Where the above 2 environmens are updated every 2 weeks, this environment is updated as soon as development / code review is completed. You can also use our Swagger tool (mentioned below) to gain valuable testing insights into our APIs.
The Staging API endpoint is: https://gfp-api.acdev.io. Data from this environment can be viewed via the admin panel at https://gfp-admin.acdev.io/.
Swagger (Optional)Â
In our staging environment we have an API tool (that you can login using the credentials you use to access the Staging Admin Panel) which will act like a Postman specific to our API applications for testing API calls, URLs, Headers, and Body values. The following URL and access is available only in our Staging environment, and is NOT available in Sandbox or Production.  Almost all of these APIs are internal and do not need to be used externally.
​​https://gfp-test-api.acdev.io/

Credentials will be provided.