Sample code for 30+ languages & platforms
C Requires Chilkat v11.7.0+

Stripe: Match an automatic bank payout to its transactions

See more Stripe Examples

Reconcile a selected automatic payout by comparing its amount with the sum of its settlement entries across all result pages.

Stripe documentation and cURL example

Chilkat C Downloads

C
#include <C_CkHttpCurl.h>
#include <C_CkStringBuilder.h>
#include <C_CkJsonObject.h>

void ChilkatSample(void)
    {
    BOOL success;
    const char *apiKey;
    HCkHttpCurl curl;
    HCkStringBuilder cmd;
    HCkJsonObject json;
    int replaced;
    const char *fromTime;
    const char *untilTime;
    const char *selectedPayout;
    const char *expectedAmount;
    const char *currency;
    HCkStringBuilder pageSuffix;
    BOOL more;
    const char *cursor;
    int i;
    int count;
    const char *next;
    int totalNet;
    HCkStringBuilder number;
    HCkStringBuilder pageSuffixTxn;
    BOOL moreTxn;
    const char *cursorTxn;
    int iTxn;
    int countTxn;
    const char *netText;
    int entryNet;
    const char *nextTxn;

    success = FALSE;

    //  Requires an unlocked Chilkat bundle. See Global Unlock Sample.
    //  Supply a restricted sandbox key from merchant-controlled configuration.
    apiKey = "YOUR_STRIPE_TEST_KEY";

    curl = CkHttpCurl_Create();
    cmd = CkStringBuilder_Create();
    json = CkJsonObject_Create();

    //  Example UTC interval: 1 October 2026 inclusive through 1 November exclusive.
    fromTime = "1790812800";
    untilTime = "1793491200";

    selectedPayout = "po_SELECTED_BANK_DEPOSIT";

    expectedAmount = "";
    currency = "";

    pageSuffix = CkStringBuilder_Create();
    more = TRUE;
    cursor = "";
    while ((more == TRUE)) {
        //  curl -X GET "https://api.stripe.com/v1/payouts?created%5Bgte%5D={fromTime}&created%5Blt%5D={untilTime}&limit=100" \
        //    -u "$STRIPE_API_KEY:" \
        //    -H "Stripe-Version: 2026-10-28.endive"
        CkStringBuilder_SetString(cmd,"curl -X GET \"https://api.stripe.com/v1/payouts?created%5Bgte%5D=@FROM@&created%5Blt%5D=@UNTIL@&limit=100@CURSOR@\"");
        CkStringBuilder_Append(cmd," -u \"@KEY@:\"");
        CkStringBuilder_Append(cmd," -H \"Stripe-Version: 2026-10-28.endive\"");
        replaced = CkStringBuilder_Replace(cmd,"@CURSOR@",CkStringBuilder_getAsString(pageSuffix));
        replaced = CkStringBuilder_Replace(cmd,"@FROM@",fromTime);
        replaced = CkStringBuilder_Replace(cmd,"@UNTIL@",untilTime);
        replaced = CkStringBuilder_Replace(cmd,"@KEY@",apiKey);
        success = CkHttpCurl_DoYourThing(curl,CkStringBuilder_getAsString(cmd));
        if (success != TRUE) {
            printf("No HTTP response. Chilkat failure code: %d\n",CkHttpCurl_getFailReason(curl));
            CkHttpCurl_Dispose(curl);
            CkStringBuilder_Dispose(cmd);
            CkJsonObject_Dispose(json);
            CkStringBuilder_Dispose(pageSuffix);
            return;
        }

        success = CkHttpCurl_GetResponseJson(curl,json);
        if ((CkHttpCurl_getStatusCode(curl) != 200) || (success != TRUE)) {
            printf("Stripe HTTP %d  Request-Id: %s\n",CkHttpCurl_getStatusCode(curl),CkHttpCurl_getResponseHeaderField(curl,"Request-Id"));
            if (success == TRUE) {
                printf("%s\n",CkJsonObject_stringOf(json,"error.message"));
            }

            CkHttpCurl_Dispose(curl);
            CkStringBuilder_Dispose(cmd);
            CkJsonObject_Dispose(json);
            CkStringBuilder_Dispose(pageSuffix);
            return;
        }

        i = 0;
        count = CkJsonObject_SizeOfArray(json,"data");
        while ((i < count)) {
            CkJsonObject_putI(json,i);
            printf("%s | %s | %s | %s\n",CkJsonObject_stringOf(json,"data[i].id"),CkJsonObject_stringOf(json,"data[i].amount"),CkJsonObject_stringOf(json,"data[i].currency")
                ,CkJsonObject_stringOf(json,"data[i].reconciliation_status"));
            if (CkJsonObject_stringOf(json,"data[i].id") == selectedPayout) {
                if ((CkJsonObject_BoolOf(json,"data[i].automatic") != TRUE) || (CkJsonObject_stringOf(json,"data[i].reconciliation_status") != "completed")) {
                    printf("Select an automatic payout with completed reconciliation.\n");
                    CkHttpCurl_Dispose(curl);
                    CkStringBuilder_Dispose(cmd);
                    CkJsonObject_Dispose(json);
                    CkStringBuilder_Dispose(pageSuffix);
                    return;
                }

                expectedAmount = CkJsonObject_stringOf(json,"data[i].amount");
                currency = CkJsonObject_stringOf(json,"data[i].currency");
            }

            i = i + 1;
        }

        more = CkJsonObject_BoolOf(json,"has_more");
        if (more == TRUE) {
            next = CkJsonObject_stringOf(json,"data[i].id");
            if ((count < 1) || (next == "") || (next == cursor)) {
                printf("Invalid pagination cursor.\n");
                CkHttpCurl_Dispose(curl);
                CkStringBuilder_Dispose(cmd);
                CkJsonObject_Dispose(json);
                CkStringBuilder_Dispose(pageSuffix);
                return;
            }

            cursor = next;
            CkStringBuilder_SetString(pageSuffix,"&starting_after=");
            CkStringBuilder_Append(pageSuffix,cursor);
        }

    }

    if (expectedAmount == "") {
        printf("The selected payout was not in this date range.\n");
        CkHttpCurl_Dispose(curl);
        CkStringBuilder_Dispose(cmd);
        CkJsonObject_Dispose(json);
        CkStringBuilder_Dispose(pageSuffix);
        return;
    }

    totalNet = 0;
    //  This portable example uses int for arithmetic. Reject an out-of-range entry
    //  or sum before adding. A larger ledger can sum the exact strings using decimal arithmetic.
    number = CkStringBuilder_Create();

    pageSuffixTxn = CkStringBuilder_Create();
    moreTxn = TRUE;
    cursorTxn = "";
    while ((moreTxn == TRUE)) {
        //  curl -X GET "https://api.stripe.com/v1/balance_transactions?payout={selectedPayout}&limit=100" \
        //    -u "$STRIPE_API_KEY:" \
        //    -H "Stripe-Version: 2026-10-28.endive"
        CkStringBuilder_SetString(cmd,"curl -X GET \"https://api.stripe.com/v1/balance_transactions?payout=@PAYOUT@&limit=100@CURSOR@\"");
        CkStringBuilder_Append(cmd," -u \"@KEY@:\"");
        CkStringBuilder_Append(cmd," -H \"Stripe-Version: 2026-10-28.endive\"");
        replaced = CkStringBuilder_Replace(cmd,"@CURSOR@",CkStringBuilder_getAsString(pageSuffixTxn));
        replaced = CkStringBuilder_Replace(cmd,"@PAYOUT@",selectedPayout);
        replaced = CkStringBuilder_Replace(cmd,"@KEY@",apiKey);
        success = CkHttpCurl_DoYourThing(curl,CkStringBuilder_getAsString(cmd));
        if (success != TRUE) {
            printf("No HTTP response. Chilkat failure code: %d\n",CkHttpCurl_getFailReason(curl));
            CkHttpCurl_Dispose(curl);
            CkStringBuilder_Dispose(cmd);
            CkJsonObject_Dispose(json);
            CkStringBuilder_Dispose(pageSuffix);
            CkStringBuilder_Dispose(number);
            CkStringBuilder_Dispose(pageSuffixTxn);
            return;
        }

        success = CkHttpCurl_GetResponseJson(curl,json);
        if ((CkHttpCurl_getStatusCode(curl) != 200) || (success != TRUE)) {
            printf("Stripe HTTP %d  Request-Id: %s\n",CkHttpCurl_getStatusCode(curl),CkHttpCurl_getResponseHeaderField(curl,"Request-Id"));
            if (success == TRUE) {
                printf("%s\n",CkJsonObject_stringOf(json,"error.message"));
            }

            CkHttpCurl_Dispose(curl);
            CkStringBuilder_Dispose(cmd);
            CkJsonObject_Dispose(json);
            CkStringBuilder_Dispose(pageSuffix);
            CkStringBuilder_Dispose(number);
            CkStringBuilder_Dispose(pageSuffixTxn);
            return;
        }

        iTxn = 0;
        countTxn = CkJsonObject_SizeOfArray(json,"data");
        while ((iTxn < countTxn)) {
            CkJsonObject_putI(json,iTxn);
            printf("%s  %s\n",CkJsonObject_stringOf(json,"data[i].id"),CkJsonObject_stringOf(json,"data[i].net"));
            if (CkJsonObject_stringOf(json,"data[i].currency") != currency) {
                printf("Currency mismatch.\n");
                CkHttpCurl_Dispose(curl);
                CkStringBuilder_Dispose(cmd);
                CkJsonObject_Dispose(json);
                CkStringBuilder_Dispose(pageSuffix);
                CkStringBuilder_Dispose(number);
                CkStringBuilder_Dispose(pageSuffixTxn);
                return;
            }

            //  Exclude the bank withdrawal itself if it appears in this batch.
            if (CkJsonObject_stringOf(json,"data[i].source") != selectedPayout) {
                netText = CkJsonObject_stringOf(json,"data[i].net");
                entryNet = CkJsonObject_IntOf(json,"data[i].net");
                CkStringBuilder_putIntValue(number,entryNet);
                if (CkStringBuilder_getAsString(number) != netText) {
                    printf("Entry exceeds the supported int range: %s\n",netText);
                    CkHttpCurl_Dispose(curl);
                    CkStringBuilder_Dispose(cmd);
                    CkJsonObject_Dispose(json);
                    CkStringBuilder_Dispose(pageSuffix);
                    CkStringBuilder_Dispose(number);
                    CkStringBuilder_Dispose(pageSuffixTxn);
                    return;
                }

                if (entryNet > 0) {
                    if (totalNet > (2147483647 - entryNet)) {
                        printf("Total exceeds the supported int range.\n");
                        CkHttpCurl_Dispose(curl);
                        CkStringBuilder_Dispose(cmd);
                        CkJsonObject_Dispose(json);
                        CkStringBuilder_Dispose(pageSuffix);
                        CkStringBuilder_Dispose(number);
                        CkStringBuilder_Dispose(pageSuffixTxn);
                        return;
                    }

                }

                if (entryNet < 0) {
                    if (totalNet < ((0 - 2147483647) - (entryNet + 1))) {
                        printf("Total exceeds the supported int range.\n");
                        CkHttpCurl_Dispose(curl);
                        CkStringBuilder_Dispose(cmd);
                        CkJsonObject_Dispose(json);
                        CkStringBuilder_Dispose(pageSuffix);
                        CkStringBuilder_Dispose(number);
                        CkStringBuilder_Dispose(pageSuffixTxn);
                        return;
                    }

                }

                totalNet = totalNet + entryNet;
            }

            iTxn = iTxn + 1;
        }

        moreTxn = CkJsonObject_BoolOf(json,"has_more");
        if (moreTxn == TRUE) {
            nextTxn = CkJsonObject_stringOf(json,"data[i].id");
            if ((countTxn < 1) || (nextTxn == "") || (nextTxn == cursorTxn)) {
                printf("Invalid pagination cursor.\n");
                CkHttpCurl_Dispose(curl);
                CkStringBuilder_Dispose(cmd);
                CkJsonObject_Dispose(json);
                CkStringBuilder_Dispose(pageSuffix);
                CkStringBuilder_Dispose(number);
                CkStringBuilder_Dispose(pageSuffixTxn);
                return;
            }

            cursorTxn = nextTxn;
            CkStringBuilder_SetString(pageSuffixTxn,"&starting_after=");
            CkStringBuilder_Append(pageSuffixTxn,cursorTxn);
        }

    }

    CkStringBuilder_putIntValue(number,totalNet);
    printf("Settlement net: %d  Bank payout: %s %s\n",totalNet,expectedAmount,currency);
    if (CkStringBuilder_getAsString(number) == expectedAmount) {
        printf("Payout reconciled.\n");
    }
    else {
        printf("Investigate the difference.\n");
    }



    CkHttpCurl_Dispose(curl);
    CkStringBuilder_Dispose(cmd);
    CkJsonObject_Dispose(json);
    CkStringBuilder_Dispose(pageSuffix);
    CkStringBuilder_Dispose(number);
    CkStringBuilder_Dispose(pageSuffixTxn);

    }