{"id":8993,"date":"2024-06-08T16:18:49","date_gmt":"2024-06-08T16:18:49","guid":{"rendered":"https:\/\/ccbill.com\/doc\/?post_type=tjspw&p=8993"},"modified":"2026-04-08T12:39:55","modified_gmt":"2026-04-08T12:39:55","slug":"python","status":"publish","type":"tjspw","link":"https:\/\/ccbill.com\/doc\/tjspw\/python","title":{"rendered":"Python"},"content":{"rendered":"\n
\n
\n
\n

Python<\/h2>\n\t\t\t

\n\t\t\tThe code example is written in Python. It describes the steps required to perform authentication with the CCBill API and the payment token obtained using the CCBill API Payment Widget to perform the charge by payment token action (non-3DSecure and 3DSecure versions). This script covers the backend portion of the integration with the CCBill's RESTful Transaction API\n\t\t\t<\/p>\n

\n

1.<\/span> Install Libraries<\/h3>\n

The Python backend uses the requests library to send API requests. Download the module using the PIP package manager:\n <\/p>\n\t\t\t\tpip install requests<\/code>\n\t\t\t\t

Import the requests<\/code><\/strong> library and the requests.HTTPBasicAuth<\/code><\/strong> module.<\/p>\n <\/article>\n

\n

2.<\/span> Define Endpoints<\/h3>\n

The endpoints section defines the API endpoints you will use throughout the process. The example uses three endpoints to demonstrate the charge flow:\n <\/p>\n

\n 1. token_endpoint<\/code><\/strong> allows requesting the CCBill Auth (Bearer) token required for authentication in subsequent operations.\n <\/p>\n\t\t\t\t

\n 2. non_threeds_transaction_endpoint<\/code><\/strong> allows performing a non-3DSecured charge transaction using the payment token.\n <\/p>\n\t\t\t\t

\n 3. threeds_transaction_endpoint<\/code><\/strong> allows performing a 3DSecured charge transaction using the payment token and previously obtained SCA parameters.\n <\/p>\n <\/article>\n

\n

3.<\/span> Provide Client Credentials<\/h3>\n\t\t\t\t

Set your Merchant Application ID<\/strong> as the value of client_id<\/code><\/strong> and the Merchant Secret<\/strong> as the value of client_secret<\/code><\/strong>.<\/p>\n\t\t\t\t

The example code will set the accessToken<\/code><\/strong> value when the script executes.<\/p>\n <\/article>\n

\n

4.<\/span> Add Data<\/h3>\n

Provide the appropriate data for the request. To create a charge, the following parameters are obtained using the payment widget:\n <\/p>\n\t\t\t\t

1. The payment_token<\/code><\/strong> previously obtained using the payment widget.<\/p>

Ensure the client's IP address is added as a payload (ipAddress<\/code><\/strong>) or header (X-Origin-IP<\/strong>) parameter.<\/p>\n\t\t\t\t

2. transaction_data<\/code><\/strong>, including the client account number, subaccount, the initial price, and period.<\/p>\n\t\t\t\t

3. If using 3DS, provide the threeds_parameters<\/code><\/strong> previously obtained using the payment widget.<\/p>\n <\/article>\n

\n

5.<\/span> Generate Token<\/h3>\n\t\t\t\t

Create a function to fetch the OAuth token (get_oauth_token<\/code><\/strong>). The function requires the client ID, client secret, and token endpoint to request the token.<\/p>\n

The token helps authenticate the payment requests.\n <\/p>\n <\/article>\n\t\t\t

\n

6.<\/span> Charge Transaction and Handle Response<\/h3>\n\t\t\t\t

The charge_transaction<\/code><\/strong> function performs the charge based on the provided endpoint, data, payment token, and generated access token.<\/p>\n

If calling the function throws no errors, the response is passed to the handle_response<\/code><\/strong> function.<\/p>\n\t\t\t\t

In this case, it only logs the response data. In a realistic scenario, it would allow you to continue processing the transaction and return the response to your client.<\/p>\n <\/article>\n\t\t\t

\n

7.<\/span> Test Transaction<\/h3>\n\t\t\t\t

The code fetches the OAuth token based on the previously provided data.<\/p>\n

If the access token is generated successfully, the code performs a non-3DS transaction and then a 3DSecure transaction using the previously obtained SCA and other transaction data.<\/p>\n <\/article>\n <\/div>\n<\/div>\n\n\n\n

\n
\n
\n backend.py<\/span>\n <\/div>\n
\n
\n
\n # import libraries\n import requests\n from requests.auth import HTTPBasicAuth\n <\/code>\n <\/div>\n # endpoints\nbase_url = \"https:\/\/api.ccbill.com\"<\/code>\n
\n token_endpoint = f\"{base_url}\/ccbill-auth\/oauth\/token\"<\/code>\n <\/div>\n
\n non_threeds_transaction_endpoint = f\"{base_url}\/transactions\/payment-tokens\/\"<\/code>\n <\/div>\n
\n threeds_transaction_endpoint = f\"{non_threeds_transaction_endpoint}threeds\/\"<\/code>\n <\/div>\n # client credentials<\/code>\n
\n client_id = \"YOUR-CLIENT-ID\"\nclient_secret = \"YOUR-CLIENT-SECRET\"<\/code>\n <\/div>\n
\n access_token = \"\" # the access token will be obtained during script execution<\/code>\n <\/div>\n # requests data<\/code>\n
\n payment_token = \"YOUR-PAYMENT-TOKEN\";<\/code>\n <\/div>\n
\n transaction_data = {\n \"clientAccnum\": 900000,\n \"clientSubacc\": 0,\n \"initialPrice\": 0,\n \"initialPeriod\": 0\n }<\/code>\n <\/div>\n
\n threeds_parameters = {\n \"threedsEci\": \"00\",\n \"threedsError\": \"\",\n \"threedsStatus\": \"Y\",\n \"threedsClientTransactionId\": \"mcn-id-h76oy394utw\",\n \"threedsAcsTransId\": \"d6f15aae-2c9d-4333-a920-954be07c0c76\",\n \"threedsDsTransId\": \"d65e93c3-35ab-41ba-b307-767bfc19eae3\",\n \"threedsCurrency\": \"978\",\n \"threedsAmount\": \"10\",\n \"threedsCardToken\": \"01ae5d142g7efb4b\",\n \"threedsVersion\": \"2.1.0\",\n \"threedsCavv\": \"\",\n \"threedsXid\": \"\",\n \"threedsSuccess\": \"true\",\n \"threedsAuthenticationType\": \"01\",\n \"threedsAuthenticationValue\": \"5VdhGOTXBJw9+kEBOTtaJiLUAr8=\"\n }<\/code>\n <\/div>\n
\n def\n get_oauth_token(token_endpoint, client_id, client_secret):\n\n data = {\n \"grant_type\": \"client_credentials\"\n }\n\n response = requests.post(\n token_endpoint,\n data=data,\n auth=HTTPBasicAuth(client_id, client_secret)\n )\n\n if response.status_code == 200:\n return response.json().get(\"access_token\")\n else:\n print(\"Token request failed with status code:\", response.status_code)\n print(\"Response content:\", response.content)\n return None\n <\/code>\n <\/div>\n
\n def\n charge_transaction(endpoint, access_token, payment_token,\n transaction_data):\n\n headers = {\n \"Authorization\": f\"Bearer {access_token}\"\n }\n\n response = requests.post(\n f\"{endpoint}{payment_token}\",\n json=transaction_data,\n headers=headers\n )\n\n handle_response(response)\n <\/code>\n <\/div>\n
\n def\n handle_response(response):\n if response.status_code == 200:\n print(\"Response: \", response.json())\n else:\n print(\"Error: \", response.content)\n return None\n <\/code>\n <\/div>\n if __name__ == \"__main__\":<\/code>\n
\n \n # get access token\n access_token = get_oauth_token(token_endpoint, client_id,\n client_secret)\n <\/code>\n <\/div>\n
\n \n if access_token:\n\n # charge regular transaction\n charge_transaction(\n non_threeds_transaction_endpoint,\n access_token,\n payment_token,\n transaction_data\n )\n\n # charge threeds verified transaction\n charge_transaction(threeds_transaction_endpoint,\n access_token,\n payment_token,\n {**transaction_data, **threeds_parameters}\n )\n <\/code>\n <\/div>\n <\/div>\n <\/div>\n<\/div>\n<\/div>\n","protected":false},"author":4,"featured_media":0,"template":"","meta":{"_acf_changed":false,"kk_blocks_editor_width":"","_kiokenblocks_attr":"","_kiokenblocks_dimensions":""},"backend":[67],"frontend":[],"class_list":["post-8993","tjspw","type-tjspw","status-publish","hentry","backend-python"],"acf":[],"yoast_head":"\nPython - CCBill Doc<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ccbill.com\/doc\/tjspw\/python\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Python - CCBill Doc\" \/>\n<meta property=\"og:description\" content=\"Python The code example is written in Python. It describes the steps required to perform...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ccbill.com\/doc\/tjspw\/python\" \/>\n<meta property=\"og:site_name\" content=\"CCBill Doc\" \/>\n<meta property=\"article:modified_time\" content=\"2026-04-08T12:39:55+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ccbill.com\/doc\/tjspw\/python\",\"url\":\"https:\/\/ccbill.com\/doc\/tjspw\/python\",\"name\":\"Python - CCBill Doc\",\"isPartOf\":{\"@id\":\"https:\/\/ccbill.com\/doc\/#website\"},\"datePublished\":\"2024-06-08T16:18:49+00:00\",\"dateModified\":\"2026-04-08T12:39:55+00:00\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ccbill.com\/doc\/tjspw\/python\"]}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ccbill.com\/doc\/#website\",\"url\":\"https:\/\/ccbill.com\/doc\/\",\"name\":\"CCBill Doc\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/ccbill.com\/doc\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Python - CCBill Doc","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/ccbill.com\/doc\/tjspw\/python","og_locale":"en_US","og_type":"article","og_title":"Python - CCBill Doc","og_description":"Python The code example is written in Python. It describes the steps required to perform...","og_url":"https:\/\/ccbill.com\/doc\/tjspw\/python","og_site_name":"CCBill Doc","article_modified_time":"2026-04-08T12:39:55+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ccbill.com\/doc\/tjspw\/python","url":"https:\/\/ccbill.com\/doc\/tjspw\/python","name":"Python - CCBill Doc","isPartOf":{"@id":"https:\/\/ccbill.com\/doc\/#website"},"datePublished":"2024-06-08T16:18:49+00:00","dateModified":"2026-04-08T12:39:55+00:00","inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ccbill.com\/doc\/tjspw\/python"]}]},{"@type":"WebSite","@id":"https:\/\/ccbill.com\/doc\/#website","url":"https:\/\/ccbill.com\/doc\/","name":"CCBill Doc","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ccbill.com\/doc\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/tjspw\/8993"}],"collection":[{"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/tjspw"}],"about":[{"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/types\/tjspw"}],"author":[{"embeddable":true,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/users\/4"}],"wp:attachment":[{"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/media?parent=8993"}],"wp:term":[{"taxonomy":"backend","embeddable":true,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/backend?post=8993"},{"taxonomy":"frontend","embeddable":true,"href":"https:\/\/ccbill.com\/doc\/wp-json\/wp\/v2\/frontend?post=8993"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}