Testing

Build and test on the stage environment, then switch to production when you go live.


What stage is for

Stage runs the same API as production at https://stage-api.hyfin.app. It has its own data and its own API tokens: a stage token does not work on production, and nothing you create on stage shows up there.

Email api-support@hyfin.app for a stage token and a test site, and ask them to turn on API access for that site.

Texts and emails are real

Stage sends real texts and emails. Put your own email address and phone number on test customers and contacts, so invoices and reminders come to you and never to a real customer.

Test payments

Ask for a test site whose payment gateway is in test mode, so no real money moves. Which card and bank account numbers work depends on the gateway, so ask for the ones that work on your test site too.

Webhooks

Stage sends webhooks just like production. Point webhookUrl at a public HTTPS URL that shows you what is posted to it. A request bin works for testing.

Going live

Ask for a production token, send your requests to https://api.hyfin.app, and use the production site_id of each merchant. Each production site needs API access turned on too.