Get a payout
curl --request GET \
--url https://api.fintoc.com/v1/payouts/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v1/payouts/{id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v1/payouts/{id}', 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/payouts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
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/payouts/{id}"
req, _ := http.NewRequest("GET", 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.get("https://api.fintoc.com/v1/payouts/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v1/payouts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "po_BO381oEATXonG6bj",
"object": "payout",
"amount": 550000,
"created_at": "2026-03-04T14:10:00Z",
"currency": "CLP",
"mode": "live",
"recipient_account": {
"holder_id": "111111111",
"institution_id": "cl_banco_estado",
"number": "987654321",
"type": "checking_account"
},
"status": "succeeded",
"succeeded_at": "2026-03-05T12:00:00Z",
"updated_at": "2026-03-05T12:00:00Z"
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"type": "invalid_request_error",
"code": "missing_resource",
"param": "id",
"message": "No such payouts/payout: po_BO381oEATXonG6bj",
"doc_url": "https://docs.fintoc.com/reference/errors"
}
}Payouts
Get a payout
Retrieves a payout by its id. Only payouts matching the live or test mode of the API key are visible.
GET
/
v1
/
payouts
/
{id}
Get a payout
curl --request GET \
--url https://api.fintoc.com/v1/payouts/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v1/payouts/{id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v1/payouts/{id}', 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/payouts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
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/payouts/{id}"
req, _ := http.NewRequest("GET", 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.get("https://api.fintoc.com/v1/payouts/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v1/payouts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "po_BO381oEATXonG6bj",
"object": "payout",
"amount": 550000,
"created_at": "2026-03-04T14:10:00Z",
"currency": "CLP",
"mode": "live",
"recipient_account": {
"holder_id": "111111111",
"institution_id": "cl_banco_estado",
"number": "987654321",
"type": "checking_account"
},
"status": "succeeded",
"succeeded_at": "2026-03-05T12:00:00Z",
"updated_at": "2026-03-05T12:00:00Z"
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"type": "invalid_request_error",
"code": "missing_resource",
"param": "id",
"message": "No such payouts/payout: po_BO381oEATXonG6bj",
"doc_url": "https://docs.fintoc.com/reference/errors"
}
}Respuesta
The payout.
A payout is a transfer of funds Fintoc settles to a recipient bank account. Each payout groups the payment intents, charges, and refunds it disburses or discounts.
Status of the payout. One of in_progress (Fintoc is processing the transfer), succeeded (the funds reached the recipient account), canceled (the payout failed or was canceled before sending the funds), or returned (the receiving institution returned the funds).
Opciones disponibles:
in_progress, succeeded, canceled, returned Ejemplo:
"succeeded"
¿Esta página le ayudó?