Standard Integration

​

Prerequisites

To get the most out of this guide, you’ll need to:

• Create an account on Creem.io
• Have your API key ready

​

1. Create a product

Go over to the products tab and create a product. You can add a name, description, and price to your product. Optionally you can also add a picture to your product that will be shown to users.

​

2 Create a checkout session

Once your product is created, you can copy the product ID by clicking on the product options and selecting “Copy ID”.

Now grab your api-key and create a checkout session by sending a POST request to the following endpoint:

​

3. Redirect user to checkout url

Once you have created a checkout session, you will receive a checkout URL in the response.

Redirect the user to this URL and that is it! You have successfully created a checkout session and received your first payment!

​

4. Receive payment data on your Return URL

A return URL will always contain the following query parameters, and will look like the following:

Query parameter	Description
checkout_id	The ID of the checkout session created for this payment.
order_id	The ID of the order created after successful payment.
customer_id	The customer ID, based on the email that executed the successful payment.
subscription_id	The subscription ID of the product.
product_id	The product ID that the payment is related to.
request_id	Optional The request ID you provided when creating this checkout session.
signature	All previous parameters signed by creem using your API-key, verifiable by you.

​

Expanding your integration

You can also use webhooks to check payment data dynamically in your application, without the need to wait for the return URLs, or have the user redirected to your application website.