Obtener Método de Pago
curl --request GET \
--url http://api.gu1.ai/entities/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/entities/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/entities/{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 => "http://api.gu1.ai/entities/{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: Bearer <token>"
],
]);
$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 := "http://api.gu1.ai/entities/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/entities/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/entities/{id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"id": "<string>",
"entityType": "<string>",
"entityData": {
"paymentMethod": {}
},
"relationships": [
{}
],
"metadata": {},
"riskScore": 123,
"riskFactors": [
{}
],
"createdAt": "<string>",
"updatedAt": "<string>"
}Referencia API
Obtener Método de Pago
Recuperar una entidad de método de pago por ID — en el modelo de entidades gu1 para tarjetas, cuentas y billeteras, con ejemplos para get.
GET
/
entities
/
{id}
Obtener Método de Pago
curl --request GET \
--url http://api.gu1.ai/entities/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/entities/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/entities/{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 => "http://api.gu1.ai/entities/{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: Bearer <token>"
],
]);
$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 := "http://api.gu1.ai/entities/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/entities/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/entities/{id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"id": "<string>",
"entityType": "<string>",
"entityData": {
"paymentMethod": {}
},
"relationships": [
{}
],
"metadata": {},
"riskScore": 123,
"riskFactors": [
{}
],
"createdAt": "<string>",
"updatedAt": "<string>"
}Descripción General
Recupera información detallada sobre una entidad de método de pago específica incluyendo sus datos, relaciones y metadatos.Endpoint
GET http://api.gu1.ai/entities/{id}
Autenticación
Requiere una clave API válida en el encabezado de Autorización:Authorization: Bearer YOUR_API_KEY
Parámetros de Ruta
string
required
UUID de la entidad de método de pago a recuperar
Ejemplos de Solicitudes
curl -X GET "http://api.gu1.ai/entities/payment-method-uuid-123" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'http://api.gu1.ai/entities/payment-method-uuid-123',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const paymentMethod = await response.json();
console.log(paymentMethod.entityData.paymentMethod);
import requests
response = requests.get(
'http://api.gu1.ai/entities/payment-method-uuid-123',
headers={
'Authorization': 'Bearer YOUR_API_KEY'
}
)
payment_method = response.json()
print(payment_method['entityData']['paymentMethod'])
Respuesta
boolean
Si la solicitud fue exitosa
string
UUID de la entidad de método de pago
string
Siempre
"payment_method"object
Datos del método de pago
Show propiedades
Show propiedades
object
Detalles del método de pago (la estructura varía según el tipo)
array
Array de relaciones con otras entidades (propietarios, transacciones, dispositivos)
object
Metadatos adicionales
number
Puntuación de riesgo calculada (si se analizó)
array
Array de factores de riesgo identificados
string
Marca de tiempo ISO 8601 de la creación
string
Marca de tiempo ISO 8601 de la última actualización
Ejemplos de Respuesta
Respuesta de Tarjeta de Crédito
{
"success": true,
"id": "payment-method-uuid-123",
"entityType": "payment_method",
"entityData": {
"paymentMethod": {
"type": "credit_card",
"last4": "4242",
"brand": "visa",
"expiryMonth": "12",
"expiryYear": "2025",
"holderName": "John Doe",
"issuerCountry": "BR",
"bin": "424242",
"funding": "credit",
"fingerprint": "abc123xyz"
}
},
"relationships": [
{
"targetEntityId": "person-uuid-123",
"relationshipType": "owns",
"strength": 1.0,
"metadata": {
"since": "2024-01-15"
}
}
],
"riskScore": 15,
"riskFactors": [
{
"type": "high_velocity",
"severity": "low",
"description": "Múltiples transacciones en corto período de tiempo"
}
],
"createdAt": "2024-01-15T10:00:00.000Z",
"updatedAt": "2024-12-23T10:00:00.000Z"
}
Respuesta de Cuenta Bancaria
{
"success": true,
"id": "payment-method-uuid-456",
"entityType": "payment_method",
"entityData": {
"paymentMethod": {
"type": "bank_account",
"accountNumber": "12345-6",
"accountType": "checking",
"bank": "Banco do Brasil",
"currency": "BRL",
"routingNumber": "001",
"holderName": "John Doe"
}
},
"relationships": [
{
"targetEntityId": "person-uuid-123",
"relationshipType": "owns",
"strength": 1.0
}
],
"riskScore": 5,
"riskFactors": [],
"createdAt": "2024-01-15T10:00:00.000Z",
"updatedAt": "2024-12-23T10:00:00.000Z"
}
Casos de Uso
Obtener Método de Pago con Detalles del Propietario
async function getPaymentMethodWithOwner(paymentMethodId) {
// Obtener método de pago
const pmResponse = await fetch(
`http://api.gu1.ai/entities/${paymentMethodId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const paymentMethod = await pmResponse.json();
// Obtener propietario (primera relación)
const ownerRelationship = paymentMethod.relationships.find(
r => r.relationshipType === 'owns'
);
if (ownerRelationship) {
const ownerResponse = await fetch(
`http://api.gu1.ai/entities/${ownerRelationship.targetEntityId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const owner = await ownerResponse.json();
return {
paymentMethod,
owner
};
}
return { paymentMethod };
}
Verificar Historial de Transacciones del Método de Pago
async function getPaymentMethodTransactions(paymentMethodId) {
// Obtener todas las transacciones vinculadas a este método de pago
const response = await fetch(
`http://api.gu1.ai/entities?entityType=transaction&relationshipWith=${paymentMethodId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const { entities } = await response.json();
return entities;
}
Respuestas de Error
404 No Encontrado
{
"error": "Entidad no encontrada",
"entityId": "payment-method-uuid-123"
}
401 No Autorizado
{
"error": "Clave API inválida o faltante"
}
Ver También
Was this page helpful?