curl --request POST \
--url https://api.fintoc.com/v1/refunds/{id}/cancel \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v1/refunds/{id}/cancel"
headers = {"Authorization": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v1/refunds/{id}/cancel', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v1/refunds/{id}/cancel",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v1/refunds/{id}/cancel"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v1/refunds/{id}/cancel")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v1/refunds/{id}/cancel")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "ref_8XzNbCv1LqKjWp4R",
"object": "refund",
"amount": 5000,
"created_at": "2026-03-04T17:04:10Z",
"currency": "CLP",
"failure_code": null,
"metadata": {
"order_id": "9182"
},
"mode": "live",
"recipient_account": {
"holder_id": "111111111",
"holder_name": "Jane Doe",
"institution_id": "cl_banco_de_chile",
"number": "123456789",
"type": "checking_account"
},
"resource_id": "pi_jsperFI9bnyM2RTo",
"resource_type": "payment_intent",
"status": "canceled",
"updated_at": "2026-03-04T17:05:42Z"
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"type": "invalid_request_error",
"code": "forbidden_request",
"param": null,
"message": "Can not cancel succeeded or in progress refund",
"doc_url": "https://docs.fintoc.com/reference/errors"
}
}{
"error": {
"type": "invalid_request_error",
"code": "missing_resource",
"param": "id",
"message": "No such refund: ref_8XzNbCv1LqKjWp4R",
"doc_url": "https://docs.fintoc.com/reference/errors"
}
}{
"error": {
"type": "conflicted_request_error",
"code": "conflicted_request",
"message": "Can not cancel succeeded or in progress refund."
}
}Cancel a refund
Cancels a refund by its id. Only refunds in pending status can be canceled; once Fintoc starts disbursing the funds, the refund cannot be canceled.
curl --request POST \
--url https://api.fintoc.com/v1/refunds/{id}/cancel \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v1/refunds/{id}/cancel"
headers = {"Authorization": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v1/refunds/{id}/cancel', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v1/refunds/{id}/cancel",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v1/refunds/{id}/cancel"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fintoc.com/v1/refunds/{id}/cancel")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v1/refunds/{id}/cancel")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "ref_8XzNbCv1LqKjWp4R",
"object": "refund",
"amount": 5000,
"created_at": "2026-03-04T17:04:10Z",
"currency": "CLP",
"failure_code": null,
"metadata": {
"order_id": "9182"
},
"mode": "live",
"recipient_account": {
"holder_id": "111111111",
"holder_name": "Jane Doe",
"institution_id": "cl_banco_de_chile",
"number": "123456789",
"type": "checking_account"
},
"resource_id": "pi_jsperFI9bnyM2RTo",
"resource_type": "payment_intent",
"status": "canceled",
"updated_at": "2026-03-04T17:05:42Z"
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"type": "invalid_request_error",
"code": "forbidden_request",
"param": null,
"message": "Can not cancel succeeded or in progress refund",
"doc_url": "https://docs.fintoc.com/reference/errors"
}
}{
"error": {
"type": "invalid_request_error",
"code": "missing_resource",
"param": "id",
"message": "No such refund: ref_8XzNbCv1LqKjWp4R",
"doc_url": "https://docs.fintoc.com/reference/errors"
}
}{
"error": {
"type": "conflicted_request_error",
"code": "conflicted_request",
"message": "Can not cancel succeeded or in progress refund."
}
}created.Response
Refund canceled. The returned refund has canceled status.
A refund returns funds from a succeeded payment to the payer. Fintoc disburses refunds asynchronously. Refund outcomes are succeeded, failed, canceled, or returned. Before disbursement completes, a refund is pending or in_progress. In Mexico, a refund can move from succeeded to the terminal status returned if the bank returns the transfer. The amount and currency are denominated in the smallest unit of the refunded resource's currency.
Current status of the refund. One of pending (the disbursement has not started), in_progress (Fintoc is disbursing the funds), succeeded (the funds reached the recipient account), returned (the bank transfer was returned after succeeding), failed (the disbursement failed; see failure_code), or canceled (the refund was canceled before disbursing).
pending, in_progress, succeeded, returned, failed, canceled "succeeded"
Was this page helpful?