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

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

Chilkat Python Downloads

Python
import sys
import chilkat2

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"
# Load the saved UUID for this operation. Reuse it only for a retry with identical inputs.
operationId = "YOUR_SAVED_OPERATION_UUID"

curl = chilkat2.HttpCurl()
cmd = chilkat2.StringBuilder()
json = chilkat2.JsonObject()

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):
    print("No HTTP response. Chilkat failure code: " + str(curl.FailReason))
    sys.exit()

success = curl.GetResponseJson(json)
if ((curl.StatusCode != 200) or (success != True)):
    print("Stripe HTTP " + str(curl.StatusCode) + "  Request-Id: " + curl.GetResponseHeaderField("Request-Id"))
    if (success == True):
        print(json.StringOf("error.message"))

    sys.exit()

print("id = " + json.StringOf("id"))
print("status = " + json.StringOf("status"))
print("amount = " + json.StringOf("amount"))
print("currency = " + json.StringOf("currency"))

# Save this refund ID with the refund request for status checks.