JavaScript Requires Chilkat v11.7.0+
JavaScript
Stripe: Issue a full or partial refund
See more Stripe Examples
Issue a partial refund against a selected payment, or refund the remaining amount by omitting the amount field.
Stripe documentation and cURL example
Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat
v11.4.0 or greater.
var success = false;
// Requires an unlocked Chilkat bundle. See Global Unlock Sample.
// Supply a restricted sandbox key from merchant-controlled configuration.
var apiKey = "YOUR_STRIPE_TEST_KEY";
// Load the saved UUID for this operation. Reuse it only for a retry with identical inputs.
var operationId = "YOUR_SAVED_OPERATION_UUID";
var curl = new CkHttpCurl();
var cmd = new CkStringBuilder();
var json = new CkJsonObject();
var replaced;
var paymentIntent = "pi_FROM_SELECTED_PAYMENT";
// The operator selected a partial refund of 500 minor units. Omit the amount field to refund the remaining balance. For a charge ID use charge= instead of payment_intent=.
// curl -X POST "https://api.stripe.com/v1/refunds" \
// -u "$STRIPE_API_KEY:" \
// -H "Stripe-Version: 2026-10-28.endive" \
// -H "Idempotency-Key: {operationId}-refund" \
// -d "payment_intent={paymentIntent}" \
// -d "amount=500"
cmd.SetString("curl -X POST \"https://api.stripe.com/v1/refunds\"");
cmd.Append(" -u \"@KEY@:\"");
cmd.Append(" -H \"Stripe-Version: 2026-10-28.endive\"");
cmd.Append(" -H \"Idempotency-Key: @OP@-refund\"");
cmd.Append(" -d \"payment_intent=@PAYMENT@\"");
cmd.Append(" -d \"amount=500\"");
replaced = cmd.Replace("@PAYMENT@",paymentIntent);
replaced = cmd.Replace("@OP@",operationId);
replaced = cmd.Replace("@KEY@",apiKey);
success = curl.DoYourThing(cmd.GetAsString());
if (success !== true) {
console.log("No HTTP response. Chilkat failure code: " + curl.FailReason);
return;
}
success = curl.GetResponseJson(json);
if ((curl.StatusCode !== 200) || (success !== true)) {
console.log("Stripe HTTP " + curl.StatusCode + " Request-Id: " + curl.GetResponseHeaderField("Request-Id"));
if (success == true) {
console.log(json.StringOf("error.message"));
}
return;
}
console.log("id = " + json.StringOf("id"));
console.log("status = " + json.StringOf("status"));
console.log("amount = " + json.StringOf("amount"));
console.log("currency = " + json.StringOf("currency"));
// Save this refund ID with the refund request for status checks.