Get a payment intent
curl --request GET \
--url https://api.fintoc.com/v2/payment_intents/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/payment_intents/{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/v2/payment_intents/{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/v2/payment_intents/{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/v2/payment_intents/{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/v2/payment_intents/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/payment_intents/{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": "pi_2cKoy3PEXAuvkr4ofXC1KdMvCgZ",
"object": "payment_intent",
"amount": 5000,
"business_profile": {
"category": "retail",
"name": "Mi Comercio SpA",
"tax_id": "777777777"
},
"created_at": "2026-02-10T15:23:11Z",
"currency": "CLP",
"customer": {
"id": "cus_2bArifJWQ6CiZSofWxBNL1Hri2u",
"object": "customer",
"address": null,
"created_at": "2026-02-01T12:00:00Z",
"email": "customer@example.com",
"metadata": {},
"mode": "live",
"name": "Test Customer 1",
"phone": "+56911111111",
"tax_id": {
"type": "cl_rut",
"value": "111111111"
}
},
"customer_email": "customer@example.com",
"error_reason": null,
"expires_at": null,
"invoices": [],
"metadata": {},
"mode": "live",
"next_action": null,
"payment_method": null,
"payment_type": "bank_transfer",
"payment_type_options": {},
"recipient_account": {
"holder_id": "111111111",
"institution_id": "cl_banco_de_chile",
"number": "123456",
"type": "checking_account"
},
"reference_id": "90123712",
"sender_account": {
"holder_id": "222222222",
"institution_id": "cl_banco_estado",
"number": "123456",
"type": "checking_account"
},
"split": null,
"split_applied": null,
"status": "succeeded",
"transaction_date": "2026-02-10T15:24:15Z",
"widget_token": null
}{
"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 payment_intent: pi_nonexistent",
"doc_url": "https://docs.fintoc.com/reference/errors"
}
}Payment intents
Get a payment intent
Retrieves the payment intent with the given id. The payment intent must belong to your organization and match the live or test mode of the API key used. Available for organizations on API version 2026-02-01 or later.
GET
/
v2
/
payment_intents
/
{id}
Get a payment intent
curl --request GET \
--url https://api.fintoc.com/v2/payment_intents/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/payment_intents/{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/v2/payment_intents/{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/v2/payment_intents/{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/v2/payment_intents/{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/v2/payment_intents/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/payment_intents/{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": "pi_2cKoy3PEXAuvkr4ofXC1KdMvCgZ",
"object": "payment_intent",
"amount": 5000,
"business_profile": {
"category": "retail",
"name": "Mi Comercio SpA",
"tax_id": "777777777"
},
"created_at": "2026-02-10T15:23:11Z",
"currency": "CLP",
"customer": {
"id": "cus_2bArifJWQ6CiZSofWxBNL1Hri2u",
"object": "customer",
"address": null,
"created_at": "2026-02-01T12:00:00Z",
"email": "customer@example.com",
"metadata": {},
"mode": "live",
"name": "Test Customer 1",
"phone": "+56911111111",
"tax_id": {
"type": "cl_rut",
"value": "111111111"
}
},
"customer_email": "customer@example.com",
"error_reason": null,
"expires_at": null,
"invoices": [],
"metadata": {},
"mode": "live",
"next_action": null,
"payment_method": null,
"payment_type": "bank_transfer",
"payment_type_options": {},
"recipient_account": {
"holder_id": "111111111",
"institution_id": "cl_banco_de_chile",
"number": "123456",
"type": "checking_account"
},
"reference_id": "90123712",
"sender_account": {
"holder_id": "222222222",
"institution_id": "cl_banco_estado",
"number": "123456",
"type": "checking_account"
},
"split": null,
"split_applied": null,
"status": "succeeded",
"transaction_date": "2026-02-10T15:24:15Z",
"widget_token": null
}{
"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 payment_intent: pi_nonexistent",
"doc_url": "https://docs.fintoc.com/reference/errors"
}
}Response
The payment intent with the given id.
Status of the payment intent. One of created (the charge was accepted and is awaiting processing), in_progress (Fintoc is processing the charge), succeeded (the charge completed), failed (the charge did not complete), rejected (the institution rejected the charge), expired (the payer did not act in time), or pending (the final status is not yet known). pending is only returned to organizations that have the pending status enabled.
Available options:
created, failed, succeeded, rejected, in_progress, pending, expired Example:
"succeeded"
Was this page helpful?