Processing channels
Last updated: April 2, 2025
You can use processing channels to group processing configurations for different parts of your business operations. For example, you may want to use processing channels to segregate traffic by payment website, brand, or merchant category code (MCC).
This gives you the flexibility to define the processing configuration for all of your payments. You can:
- Filter by processing channels in reports and entity segments.
- Set fraud detection rules for different processing channels.
By default, every entity has at least one processing channel. Within a processing channel you can set up:
- Processing configurations – Settings to process payments such as allowed payment methods and MCCs.
- A payment method is associated with a single MCC and one or more currencies. A processing channel can have multiple payment methods.
- Redirect URLs – Success or failure URLs the cardholder is redirected to after the payment flow.
Information
To create or update a processing channel, contact your account manager or [email protected].
You can route payments through different processing channels by configuring the API key or payment request. This lets you choose the appropriate channel for each payment depending on your specific processing requirements.
Create a unique API key for each processing channel:
- Sign in to the Dashboard.
- Select the Developers icon in the top navigation bar and open the Keys tab.
- Select Create a new key.
- Select Public API key in the Key details section. Optionally, you can add a description.
- In the Processing channels section that opens, select the required processing channel.
- When you call the API, authenticate the request by specifying the appropriate processing channel's API key in the authorization header.
1curl --location --request POST 'https://api.checkout.com/{{path}}' \2--header 'Content-Type: application/json' \3--header 'Accept: application/json' \4--header 'Authorization: Bearer {{Processing_channel_API_key}}' \5--data-raw '{6"amount": 10000,7"currency": "USD",8"reference": "Visa-USD-Test",9...10}'
If you do not want to use unique API keys for each processing channel, you can route a payment through a specific processing channel when you request a payment. Provide the processing_channel_id
field in the request.
Information
If you only have one processing channel configured, all payments are routed through it by default. You do not need to specify the processing channel ID in your request.
post
https://api.checkout.com/payments
1{2"source": {3"type": "token",4"token": "tok_4gzeau5o2uqubbk6fufs3m7p54",5"billing_address": {6"address_line1": "123 High St.",7"city": "London",8"zip": "SW1A 1AA",9"country": "GB"10}11},12"amount": 6540,13"currency": "USD",14"processing_channel_id": "pc_bxq7mfydz2k9t3vhg5jspwloen",15"payment_type": "Regular",16"reference": "ORD-5023-4E89",17"capture": true,18"previous_payment_id": "pay_fun26akvvjjerahhctaq2uzhu4",19"success_url": "https://example.com/payments/success",20"failure_url": "https://example.com/payments/fail",21"segment": {22"brand": "Acme Corporation",23"business_category": "Inward Payment",24"market": "UK"25}26}