One Time Payments

​

Understanding One Time Payments

A one time payment represents a single transaction between you and your customer. When a customer makes a one time payment, they are charged once for the full amount of the purchase.

​

Key Concepts

​

Payment Status

A payment can be in different states throughout its lifecycle:

• Pending: The payment has been initiated but not yet completed
• Paid: The payment has been successfully processed
• Refunded: The payment has been refunded to the customer
• Partially Refunded: The payment has been partially refunded to the customer

​

Creating a One Time Payment

To create a one time payment, you’ll need to:

1. Set up a product in your Creem dashboard
2. Generate a checkout session for the payment
3. Direct your customer to the checkout URL

​

Code Example

const paymentCheckout = await axios.post(
  `https://api.creem.io/v1/checkouts`,
  {
    product_id: 'prod_your-product-id',
    request_id: 'your-request-id',
    metadata: {
      customerId: 'your-customer-id'
    }
  },
  {
    headers: { "x-api-key": `creem_123456789` },
  }
);

​

Managing Payments

Creem provides several payment management features:

• Refund payments: Process full or partial refunds directly throught the Creem Dashboard
• Payment history: View detailed transaction history
• Payment metadata: Add custom data to payments for tracking
• Payment Custom Fields: Add custom input fields on your checkout session that your users can fill