Receive payments in virtual currencies via API integration
This guide page provides high-level, step-by-step instructions for receiving payments in a variety of virtual currencies that Coinify offers.
1. Create a PaymentIntent
Use the Create PaymentIntent endpoint and send a payload with at least the required parameters.
Note
This is a protected endpoint and the usage of your API Key is required.
By default, if no cryptocurrency is preselected before the customer is redirected to Coinify's Payment Window, the customer will land on the Select Crypto screen, where they can choose from the list of available cryptocurrencies to complete the Payment Intent. See how to preselect a cryptocurrency.
2. Redirect your customer or Host your own Payment Window
2.1. Coinify Hosted Payment Window
Coinify provides a hosted checkout user interface which enables your customer to easily send the requested amount to the correct address and also choose from a variety of virtual currencies.
The URL to the Coinify hosted checkout user interface is returned in the successful response of the Create a PaymentIntent endpoint.
2.2. Self-hosted Payment Window
The PaymentIntent resource provides you with all the necessary data to build your own Payment Window around it and provide the UX/UI that is aligned with your brand.
After a successful creation of a PaymentIntent, create a quote for the Payment Intent and retrieve the PaymentIntent in the API response, and fetch the relevant payment information from the latest quote. All the created quotes can be found in the quotes
object.
Important:
A Payment Intent will expire when the latest created quote expires! For optimal UX, do not re-use a previously crated quote. Always create a new one, even if there's an existing one for the same chosen currency!
3. Receive a Webhook notification (Callback event)
Coinify sends a callback notification to a webhook URL you provided once a PaymentIntent has been completed or failed.
If you are building a self-hosted payment window, you need to inform the customer about a successful or failed payment. The state
and stateReason
of a PaymentIntent are provided in the webhook events.
For more information on how to set up a webhook URL with Coinify and see the structure of the notifications read the Webhooks guide.
Validate the signature
Coinify includes a signature in the Header of each webhook notification request.
For more information on validating the signatures, read the Webhooks guide.
Important
Never accept a payload before validating that the signature is correct.
Completed/Failed states
Based on the state
received in a webhook notification you can determine whether the Payment Intent was successful or not and provide or reject the service/product to your end-user accordingly.
Once you receive a completed
notification that contains the correct signature, the Payment Intent was successful and your merchant account has been credited.
Once you receive a failed
notification that contains the correct signature, the PaymentIntent was not successful and your merchant account has not been credited.
Updated about 2 months ago