This endpoint enables you to securely initiate payment transactions by submitting charge details via a POST request.
These resources support advanced transaction features and integration troubleshooting:
Metatdata
To request transaction metadata, append the include query parameter to your request: /v1/charges?include=transaction_metadata
LEVEL 2 or LEVEL 3 Card Information
When creating a new charge, you have the option to provide additional card data at LEVEL2 or LEVEL3. These enhanced data levels can provide benefits such as lower Visa and Mastercard interchange rates, particularly for commercial, corporate, purchasing, business, or government cards.
The following fields are required to process a transaction with card_level set to LEVEL2:
- address_line1
- purchase_order
- sales_tax
- zip
To process transactions with card_level set to LEVEL3, you must include the fields required for LEVEL 2, along with the following additional fields:
- customer_vat_number
- destination_country_code
- duty_charges
- order_date
- ship_from_zip
- ship_to_zip
- shipping_charges
- summary_commodity_code
- tax_amount
- tax_category
- tax_rate
- tax_type
- vat_invoice
Instructional Funding (Splits)
Merchants configured with instructional funding are required to include the splits array in the request payload.
At least one valid split instruction must be provided — otherwise, the request may result in errors and could delay funding of the transaction.
API Troubleshooting
When creating a new charge, you may encounter the following error codes. Each status is associated with a specific error message. You can find a detailed error message breakdown in our Charges FAQ.