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"
}
}Get a payout
Retrieves a payout by its id. Only payouts matching the live or test mode of the API key are visible.
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"
}
}Autorizaciones
Parámetros de ruta
Unique identifier of the payout to retrieve.
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.
Unique identifier of the payout.
"po_BO381oEATXonG6bj"
Type of the object. Always payout.
Value disbursed, in the smallest unit of the currency. CLP has no decimals, so amounts are in pesos. MXN amounts are in centavos.
550000
ISO 8601 timestamp, in UTC, of when Fintoc created the payout.
"2026-03-04T14:10:00Z"
Three-letter ISO 4217 currency code, returned in uppercase.
"CLP"
Mode of the object. live objects use real institution data, test objects use fake data for integration testing.
test, live "live"
Bank account that receives the payout.
Show child attributes
Show child attributes
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).
in_progress, succeeded, canceled, returned "succeeded"
ISO 8601 timestamp, in UTC, of when the payout succeeded. null until the payout succeeds.
"2026-03-05T12:00:00Z"
ISO 8601 timestamp, in UTC, of when Fintoc last updated the payout.
"2026-03-05T12:00:00Z"
¿Esta página le ayudó?