Skip to content

Instance · Integrations

Creating a Payment in Stripe

Last updated 1 November 2026

This document guides you in creating a object in Stripe. This object charges payments from credit and debit cards, among other payment sources.

Creating a Charge

To charge a credit card or other payment source, you need to create a object. If your API key is in test mode, the supplied payment source (e.g., credit card) is not charged, although everything else occurs as if your transaction is in live mode.

  • URL:
  • Method: POST
  • Headers:
  • Purpose / Description: Creates a Stripe charge object. If is passed, it will charge the amount to the credit card.

The table below displays and describes the fields available for the request:

FieldRequired Type Options Details
amountYes Int - Amount in the smallest unit of the currency, for example cents for AUD. 100 means AUD 1.00.
currencyYes String - Charge amount currency in ISO currency code.
idempotency_keyNo String - UUID to avoid double charges.
customerNo String - Customer's Stripe ID to be charged.
sourceNo String - Credit Card's Stripe ID to be charged.
descriptionNo String - Descriptive text with other charge information will be displayed in the Stripe dashboard.
statement_descriptorNo String - For card charges, use instead. Otherwise, you can use this value as the complete charge description on your customers' statements. It must contain at least one letter and a maximum of 22 characters.
statement_descriptor_suffixNo String - Provides information about the charges customers see on their statements. Concatenated with the prefix (shortened descriptor) or statement descriptor set on the account to form the complete statement descriptor. Maximum 22 characters for the concatenated descriptor.

Sample request

Displayed below is a sample request body:

currency=AUD&amount=100&customer=cus_Im3jKIBqlilz2w&source=card_19yUNL2eZvKYlo2CNGsN6EWH&description=This%20is%20my%20first%20test%20payment.

The body is form-encoded: the fields are joined with & and special characters such as spaces are encoded. The idempotency key goes in the header, not in the body.

Note

Please visit Stripe Charges for more information.