C Requires Chilkat v11.7.0+
C
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
#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);
}