checkout_create

POST

https://api.cfxpay.io/{{param_environment}}/{{param_company}}/gateway/checkout_create

Last modified:2024-02-23 13:39:42

Use this endpoint to generate a new checkout URL for your clients to complete the entire payment process, from selecting the payment type to confirmation. If you have any questions about this flow, see Integration Types.

When you redirect your user to the generated URL they will go through the following screens:

📌

If you want to use our paywall page but need customization for your brand, please contact us.

Select payment type page

Payer information form page

Invoice page

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Header Params

Body Params application/json

Example

{
    "tracking_id": "53c4042b-a565-473b-b511-1080605e0d96",
    "amount": "951.37",
    "callback_url": "https://api.cfxpay.io/webhook_test",
    "country": "BR",
    "currency_symbol": "BRL",
    "category": "PIX",
    "description": "Payment transaction at Legros and Sons",
    "kind": "PROVIDER_01",
    "payment_type_id": "a88eb69672cc1f8483d481a56259dcaa",
    "cancel_url": "https://cfxpay.io",
    "return_url": "https://cfxpay.io"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://api.cfxpay.io/{{param_environment}}/{{param_company}}/gateway/checkout_create' \
--header 'Language: PORTUGUESE_BR' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "tracking_id": "53c4042b-a565-473b-b511-1080605e0d96",
    "amount": "951.37",
    "callback_url": "https://api.cfxpay.io/webhook_test",
    "country": "BR",
    "currency_symbol": "BRL",
    "category": "PIX",
    "description": "Payment transaction at Legros and Sons",
    "kind": "PROVIDER_01",
    "payment_type_id": "a88eb69672cc1f8483d481a56259dcaa",
    "cancel_url": "https://cfxpay.io",
    "return_url": "https://cfxpay.io"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "server": "01",
    "code": 0,
    "message": "Success",
    "identifier": "1708387760806181217",
    "type": "LOG_INFO",
    "caller": "_checkout_create",
    "caller_id": "1708387760769894631",
    "translation_message": "Sucesso",
    "gateway": [
        {
            "checkout_url": "https://checkout.cfxpay.io/#/create/U2FsdGVkX18ZZzI5NCtfjsjzMioqIWumcsGQb4yYdINe0Q9Yyu66HCxKPDmsEYt0vDVhtowqrQ98L5eS8CyzltBeB6E0BTbEhnjuDQJaMbx3GQCatP90UFxAaV2rLNbc0i_I4zKplq7o5Pm2ijAPzeCW95LikSmO7sbWH95nsTGMFXHd0ECsl0Mo6Cy_fAiy_M1NqpbU4uaOO_8C0F-tTkTukpcjvnaE3hLWiGoiW5_cbnp4dgn4R-9hFn_zlu67FRvTZnJxrqFaC6zGUU0539Mk0waZ2YgJ9_kTk1lHBDZ9bAqrL012eeBUTiUXVZeNNIzcjFHixUMbz-qTHgKppPBv0pALx3JOzwNk_mB3mYAvsjFAbloGQauuycVmznSD_dxAdB946hyWraCPL_l4SACP8__Xy-fypxwIu9AS0X2uExG-gebmjU2NxyuaxRt8jAgvQFBguZjBu90qg3H2ZExkLyxGED0LCSUBZAQDpWvzv0lJTwzFELd0VXjzuatTKzGDn_ECRY9xqgNhaYiK0Fre6OXAJKAVnhXPm4B_Ax0C8PRqjfC2RPrzBXuV-Uk0kNYN_vkOTkUZqUAI_5syL-DGKqtYDBpBGkpsV4p7FuI="
        }
    ]
}

🟠400Wrong Params

Modified at 2024-02-23 13:39:42

PIX Brazil

checkout_form