Enterprise OnlyVersion: current

Getting Started with Falcon Payments

Getting started with an existing payment provider is simple. If you want to do this manually you can do this using npm or yarn from your server directory. If you're using our BigCommerce integration this can be done through the BigCommerce admin.

1. Add the packages you need

Don't include the providers you're not using

npm install @deity/falcon-payments
npm install @deity/falcon-payments-env
npm install @deity/falcon-payments-endpoints
npm install @deity/falcon-payments-stripe
npm install @deity/falcon-payments-mollie
npm install @deity/falcon-payments-plain

2. Create a payment provider account

Each payment provider will require different credentials to get started. Normally an api key and an api secret. You'll need these to get started.

3. Configure your payment components

In your Falcon Server configuration files you can configure both your endpoints (for Webhooks) and your payment components.

{
"components": {
"payments": {
"package": "@deity/falcon-payments",
"config": {
"webhookBaseUrl": "https://myBackEndUrl.com",
"webhookUrl": "/falcon-payments/webhook",
"redirectBaseUrl": "https://myAwesomeWebsite.com",
"redirectUrl": "/checkout/pending",
"skipSurcharges": false,
"providers": {
"stripe": {
"enabled": true,
"package": "@deity/falcon-payments-stripe",
"config": {
... // API credentials go here
}
},
"mollie": {
"enabled": true,
"package": "@deity/falcon-payments-mollie",
"config": {
... // API credentials go here
}
}
}
}
}
},
"endpoints": {
"payments": {
"package": "@deity/falcon-payments-endpoints",
"config": {
"protocol": "https",
"host": "https",
"url": "/falcon-payments/webhook",
"paymentsComponent": "payments" // This indicates we are using the payments compoent, that in turn is using @deity/falcon-payments
}
}
}
}

4. Integrate with your client side app

The final step is to add your method UI components to Falcon Client and start processing payments. The best place to start is using one of our examples apps, or reading our integration guide.

Ask the community. #help

If you can't find what you're looking for, the answer might be on our community slack channel. Our team keep a close eye on this and will usually get back to you within a few hours, if not straight away. If you haven't created an account yet please sign up here slack.deity.io.

Stay up to date

Do you want to be informed when we release new features or fixes? Sign up to our newsletter to stay in the loop.