Crear Método de Pago
curl --request POST \
--url http://api.gu1.ai/entities \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"entityType": "<string>",
"entityData": {
"paymentMethod": {
"type": "<string>",
"last4": "<string>",
"brand": "<string>",
"expiryMonth": "<string>",
"expiryYear": "<string>",
"holderName": "<string>",
"issuerCountry": "<string>",
"bin": "<string>",
"fingerprint": "<string>",
"funding": "<string>",
"accountNumber": "<string>",
"accountType": "<string>",
"bank": "<string>",
"currency": "<string>",
"routingNumber": "<string>",
"provider": "<string>",
"email": "<string>",
"address": "<string>",
"network": "<string>",
"pixKey": "<string>",
"pixKeyType": "<string>"
}
},
"relationships": [
{
"targetEntityId": "<string>",
"relationshipType": "<string>",
"strength": 123,
"metadata": {}
}
],
"metadata": {}
}
'import requests
url = "http://api.gu1.ai/entities"
payload = {
"entityType": "<string>",
"entityData": { "paymentMethod": {
"type": "<string>",
"last4": "<string>",
"brand": "<string>",
"expiryMonth": "<string>",
"expiryYear": "<string>",
"holderName": "<string>",
"issuerCountry": "<string>",
"bin": "<string>",
"fingerprint": "<string>",
"funding": "<string>",
"accountNumber": "<string>",
"accountType": "<string>",
"bank": "<string>",
"currency": "<string>",
"routingNumber": "<string>",
"provider": "<string>",
"email": "<string>",
"address": "<string>",
"network": "<string>",
"pixKey": "<string>",
"pixKeyType": "<string>"
} },
"relationships": [
{
"targetEntityId": "<string>",
"relationshipType": "<string>",
"strength": 123,
"metadata": {}
}
],
"metadata": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
entityType: '<string>',
entityData: {
paymentMethod: {
type: '<string>',
last4: '<string>',
brand: '<string>',
expiryMonth: '<string>',
expiryYear: '<string>',
holderName: '<string>',
issuerCountry: '<string>',
bin: '<string>',
fingerprint: '<string>',
funding: '<string>',
accountNumber: '<string>',
accountType: '<string>',
bank: '<string>',
currency: '<string>',
routingNumber: '<string>',
provider: '<string>',
email: '<string>',
address: '<string>',
network: '<string>',
pixKey: '<string>',
pixKeyType: '<string>'
}
},
relationships: [
{
targetEntityId: '<string>',
relationshipType: '<string>',
strength: 123,
metadata: {}
}
],
metadata: {}
})
};
fetch('http://api.gu1.ai/entities', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'entityType' => '<string>',
'entityData' => [
'paymentMethod' => [
'type' => '<string>',
'last4' => '<string>',
'brand' => '<string>',
'expiryMonth' => '<string>',
'expiryYear' => '<string>',
'holderName' => '<string>',
'issuerCountry' => '<string>',
'bin' => '<string>',
'fingerprint' => '<string>',
'funding' => '<string>',
'accountNumber' => '<string>',
'accountType' => '<string>',
'bank' => '<string>',
'currency' => '<string>',
'routingNumber' => '<string>',
'provider' => '<string>',
'email' => '<string>',
'address' => '<string>',
'network' => '<string>',
'pixKey' => '<string>',
'pixKeyType' => '<string>'
]
],
'relationships' => [
[
'targetEntityId' => '<string>',
'relationshipType' => '<string>',
'strength' => 123,
'metadata' => [
]
]
],
'metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/entities"
payload := strings.NewReader("{\n \"entityType\": \"<string>\",\n \"entityData\": {\n \"paymentMethod\": {\n \"type\": \"<string>\",\n \"last4\": \"<string>\",\n \"brand\": \"<string>\",\n \"expiryMonth\": \"<string>\",\n \"expiryYear\": \"<string>\",\n \"holderName\": \"<string>\",\n \"issuerCountry\": \"<string>\",\n \"bin\": \"<string>\",\n \"fingerprint\": \"<string>\",\n \"funding\": \"<string>\",\n \"accountNumber\": \"<string>\",\n \"accountType\": \"<string>\",\n \"bank\": \"<string>\",\n \"currency\": \"<string>\",\n \"routingNumber\": \"<string>\",\n \"provider\": \"<string>\",\n \"email\": \"<string>\",\n \"address\": \"<string>\",\n \"network\": \"<string>\",\n \"pixKey\": \"<string>\",\n \"pixKeyType\": \"<string>\"\n }\n },\n \"relationships\": [\n {\n \"targetEntityId\": \"<string>\",\n \"relationshipType\": \"<string>\",\n \"strength\": 123,\n \"metadata\": {}\n }\n ],\n \"metadata\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://api.gu1.ai/entities")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"entityType\": \"<string>\",\n \"entityData\": {\n \"paymentMethod\": {\n \"type\": \"<string>\",\n \"last4\": \"<string>\",\n \"brand\": \"<string>\",\n \"expiryMonth\": \"<string>\",\n \"expiryYear\": \"<string>\",\n \"holderName\": \"<string>\",\n \"issuerCountry\": \"<string>\",\n \"bin\": \"<string>\",\n \"fingerprint\": \"<string>\",\n \"funding\": \"<string>\",\n \"accountNumber\": \"<string>\",\n \"accountType\": \"<string>\",\n \"bank\": \"<string>\",\n \"currency\": \"<string>\",\n \"routingNumber\": \"<string>\",\n \"provider\": \"<string>\",\n \"email\": \"<string>\",\n \"address\": \"<string>\",\n \"network\": \"<string>\",\n \"pixKey\": \"<string>\",\n \"pixKeyType\": \"<string>\"\n }\n },\n \"relationships\": [\n {\n \"targetEntityId\": \"<string>\",\n \"relationshipType\": \"<string>\",\n \"strength\": 123,\n \"metadata\": {}\n }\n ],\n \"metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/entities")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"entityType\": \"<string>\",\n \"entityData\": {\n \"paymentMethod\": {\n \"type\": \"<string>\",\n \"last4\": \"<string>\",\n \"brand\": \"<string>\",\n \"expiryMonth\": \"<string>\",\n \"expiryYear\": \"<string>\",\n \"holderName\": \"<string>\",\n \"issuerCountry\": \"<string>\",\n \"bin\": \"<string>\",\n \"fingerprint\": \"<string>\",\n \"funding\": \"<string>\",\n \"accountNumber\": \"<string>\",\n \"accountType\": \"<string>\",\n \"bank\": \"<string>\",\n \"currency\": \"<string>\",\n \"routingNumber\": \"<string>\",\n \"provider\": \"<string>\",\n \"email\": \"<string>\",\n \"address\": \"<string>\",\n \"network\": \"<string>\",\n \"pixKey\": \"<string>\",\n \"pixKeyType\": \"<string>\"\n }\n },\n \"relationships\": [\n {\n \"targetEntityId\": \"<string>\",\n \"relationshipType\": \"<string>\",\n \"strength\": 123,\n \"metadata\": {}\n }\n ],\n \"metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"id": "<string>",
"entityType": "<string>",
"entityData": {},
"relationships": [
{}
],
"createdAt": "<string>",
"updatedAt": "<string>"
}Referencia API
Crear Método de Pago
Crear una nueva entidad de método de pago — en el modelo de entidades gu1 para tarjetas, cuentas y billeteras, con ejemplos para create.
POST
/
entities
Crear Método de Pago
curl --request POST \
--url http://api.gu1.ai/entities \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"entityType": "<string>",
"entityData": {
"paymentMethod": {
"type": "<string>",
"last4": "<string>",
"brand": "<string>",
"expiryMonth": "<string>",
"expiryYear": "<string>",
"holderName": "<string>",
"issuerCountry": "<string>",
"bin": "<string>",
"fingerprint": "<string>",
"funding": "<string>",
"accountNumber": "<string>",
"accountType": "<string>",
"bank": "<string>",
"currency": "<string>",
"routingNumber": "<string>",
"provider": "<string>",
"email": "<string>",
"address": "<string>",
"network": "<string>",
"pixKey": "<string>",
"pixKeyType": "<string>"
}
},
"relationships": [
{
"targetEntityId": "<string>",
"relationshipType": "<string>",
"strength": 123,
"metadata": {}
}
],
"metadata": {}
}
'import requests
url = "http://api.gu1.ai/entities"
payload = {
"entityType": "<string>",
"entityData": { "paymentMethod": {
"type": "<string>",
"last4": "<string>",
"brand": "<string>",
"expiryMonth": "<string>",
"expiryYear": "<string>",
"holderName": "<string>",
"issuerCountry": "<string>",
"bin": "<string>",
"fingerprint": "<string>",
"funding": "<string>",
"accountNumber": "<string>",
"accountType": "<string>",
"bank": "<string>",
"currency": "<string>",
"routingNumber": "<string>",
"provider": "<string>",
"email": "<string>",
"address": "<string>",
"network": "<string>",
"pixKey": "<string>",
"pixKeyType": "<string>"
} },
"relationships": [
{
"targetEntityId": "<string>",
"relationshipType": "<string>",
"strength": 123,
"metadata": {}
}
],
"metadata": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
entityType: '<string>',
entityData: {
paymentMethod: {
type: '<string>',
last4: '<string>',
brand: '<string>',
expiryMonth: '<string>',
expiryYear: '<string>',
holderName: '<string>',
issuerCountry: '<string>',
bin: '<string>',
fingerprint: '<string>',
funding: '<string>',
accountNumber: '<string>',
accountType: '<string>',
bank: '<string>',
currency: '<string>',
routingNumber: '<string>',
provider: '<string>',
email: '<string>',
address: '<string>',
network: '<string>',
pixKey: '<string>',
pixKeyType: '<string>'
}
},
relationships: [
{
targetEntityId: '<string>',
relationshipType: '<string>',
strength: 123,
metadata: {}
}
],
metadata: {}
})
};
fetch('http://api.gu1.ai/entities', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'entityType' => '<string>',
'entityData' => [
'paymentMethod' => [
'type' => '<string>',
'last4' => '<string>',
'brand' => '<string>',
'expiryMonth' => '<string>',
'expiryYear' => '<string>',
'holderName' => '<string>',
'issuerCountry' => '<string>',
'bin' => '<string>',
'fingerprint' => '<string>',
'funding' => '<string>',
'accountNumber' => '<string>',
'accountType' => '<string>',
'bank' => '<string>',
'currency' => '<string>',
'routingNumber' => '<string>',
'provider' => '<string>',
'email' => '<string>',
'address' => '<string>',
'network' => '<string>',
'pixKey' => '<string>',
'pixKeyType' => '<string>'
]
],
'relationships' => [
[
'targetEntityId' => '<string>',
'relationshipType' => '<string>',
'strength' => 123,
'metadata' => [
]
]
],
'metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/entities"
payload := strings.NewReader("{\n \"entityType\": \"<string>\",\n \"entityData\": {\n \"paymentMethod\": {\n \"type\": \"<string>\",\n \"last4\": \"<string>\",\n \"brand\": \"<string>\",\n \"expiryMonth\": \"<string>\",\n \"expiryYear\": \"<string>\",\n \"holderName\": \"<string>\",\n \"issuerCountry\": \"<string>\",\n \"bin\": \"<string>\",\n \"fingerprint\": \"<string>\",\n \"funding\": \"<string>\",\n \"accountNumber\": \"<string>\",\n \"accountType\": \"<string>\",\n \"bank\": \"<string>\",\n \"currency\": \"<string>\",\n \"routingNumber\": \"<string>\",\n \"provider\": \"<string>\",\n \"email\": \"<string>\",\n \"address\": \"<string>\",\n \"network\": \"<string>\",\n \"pixKey\": \"<string>\",\n \"pixKeyType\": \"<string>\"\n }\n },\n \"relationships\": [\n {\n \"targetEntityId\": \"<string>\",\n \"relationshipType\": \"<string>\",\n \"strength\": 123,\n \"metadata\": {}\n }\n ],\n \"metadata\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://api.gu1.ai/entities")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"entityType\": \"<string>\",\n \"entityData\": {\n \"paymentMethod\": {\n \"type\": \"<string>\",\n \"last4\": \"<string>\",\n \"brand\": \"<string>\",\n \"expiryMonth\": \"<string>\",\n \"expiryYear\": \"<string>\",\n \"holderName\": \"<string>\",\n \"issuerCountry\": \"<string>\",\n \"bin\": \"<string>\",\n \"fingerprint\": \"<string>\",\n \"funding\": \"<string>\",\n \"accountNumber\": \"<string>\",\n \"accountType\": \"<string>\",\n \"bank\": \"<string>\",\n \"currency\": \"<string>\",\n \"routingNumber\": \"<string>\",\n \"provider\": \"<string>\",\n \"email\": \"<string>\",\n \"address\": \"<string>\",\n \"network\": \"<string>\",\n \"pixKey\": \"<string>\",\n \"pixKeyType\": \"<string>\"\n }\n },\n \"relationships\": [\n {\n \"targetEntityId\": \"<string>\",\n \"relationshipType\": \"<string>\",\n \"strength\": 123,\n \"metadata\": {}\n }\n ],\n \"metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/entities")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"entityType\": \"<string>\",\n \"entityData\": {\n \"paymentMethod\": {\n \"type\": \"<string>\",\n \"last4\": \"<string>\",\n \"brand\": \"<string>\",\n \"expiryMonth\": \"<string>\",\n \"expiryYear\": \"<string>\",\n \"holderName\": \"<string>\",\n \"issuerCountry\": \"<string>\",\n \"bin\": \"<string>\",\n \"fingerprint\": \"<string>\",\n \"funding\": \"<string>\",\n \"accountNumber\": \"<string>\",\n \"accountType\": \"<string>\",\n \"bank\": \"<string>\",\n \"currency\": \"<string>\",\n \"routingNumber\": \"<string>\",\n \"provider\": \"<string>\",\n \"email\": \"<string>\",\n \"address\": \"<string>\",\n \"network\": \"<string>\",\n \"pixKey\": \"<string>\",\n \"pixKeyType\": \"<string>\"\n }\n },\n \"relationships\": [\n {\n \"targetEntityId\": \"<string>\",\n \"relationshipType\": \"<string>\",\n \"strength\": 123,\n \"metadata\": {}\n }\n ],\n \"metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"id": "<string>",
"entityType": "<string>",
"entityData": {},
"relationships": [
{}
],
"createdAt": "<string>",
"updatedAt": "<string>"
}Descripción General
Crea una nueva entidad de método de pago (tarjeta de crédito, cuenta bancaria, billetera, etc.) en el sistema. Los métodos de pago pueden vincularse a entidades de personas o empresas y utilizarse para monitoreo de transacciones y detección de fraude.Endpoint
POST http://api.gu1.ai/entities
Autenticación
Requiere una clave API válida en el encabezado de Autorización:Authorization: Bearer YOUR_API_KEY
Cuerpo de la Solicitud
string
required
Debe ser
"payment_method" para entidades de método de pagoobject
required
Contenedor para datos del método de pago
Show propiedades
Show propiedades
object
required
Detalles del método de pago
Show propiedades
Show propiedades
string
required
Tipo de método de pago:
credit_card, debit_card, bank_account, digital_wallet, crypto_wallet, pixstring
Últimos 4 dígitos del número de tarjeta/cuenta
string
Marca de la tarjeta (para tarjetas):
visa, mastercard, amex, elo, hipercard, etc.string
Mes de vencimiento (para tarjetas):
01 a 12string
Año de vencimiento (para tarjetas): formato
YYYYstring
Nombre en la tarjeta/cuenta
string
Código de país emisor (ISO 3166-1 alpha-2)
string
Número de Identificación Bancaria (primeros 6 dígitos de la tarjeta)
string
Huella digital única para este método de pago
string
Tipo de financiamiento:
credit, debit, prepaid, unknownstring
Número de cuenta completo (para cuentas bancarias, encriptado)
string
Tipo de cuenta:
checking, savings, businessstring
Nombre del banco (para cuentas bancarias)
string
Código de moneda (ISO 4217):
BRL, USD, ARS, etc.string
Número de ruta (para cuentas bancarias)
string
Nombre del proveedor (para billeteras digitales):
paypal, apple_pay, google_pay, etc.string
Email asociado con la billetera (para billeteras digitales)
string
Dirección de la billetera (para billeteras de criptomonedas)
string
Nombre de la red (para criptomonedas):
bitcoin, ethereum, etc.string
Clave PIX (para métodos de pago PIX en Brasil)
string
Tipo de clave PIX:
cpf, cnpj, email, phone, randomarray
object
Metadatos adicionales para la entidad de método de pago
Ejemplos de Solicitudes
Crear Tarjeta de Crédito
curl -X POST http://api.gu1.ai/entities \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"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"
}
},
"relationships": [
{
"targetEntityId": "person-uuid-123",
"relationshipType": "owns",
"strength": 1.0
}
]
}'
const response = await fetch('http://api.gu1.ai/entities', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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'
}
},
relationships: [
{
targetEntityId: 'person-uuid-123',
relationshipType: 'owns',
strength: 1.0
}
]
})
});
const paymentMethod = await response.json();
console.log(paymentMethod.id);
import requests
response = requests.post(
'http://api.gu1.ai/entities',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
json={
'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'
}
},
'relationships': [
{
'targetEntityId': 'person-uuid-123',
'relationshipType': 'owns',
'strength': 1.0
}
]
}
)
payment_method = response.json()
print(payment_method['id'])
Crear Cuenta Bancaria
curl -X POST http://api.gu1.ai/entities \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"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
}
]
}'
const response = await fetch('http://api.gu1.ai/entities', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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
}
]
})
});
response = requests.post(
'http://api.gu1.ai/entities',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'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
}]
}
)
Crear Método de Pago PIX
curl -X POST http://api.gu1.ai/entities \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"entityType": "payment_method",
"entityData": {
"paymentMethod": {
"type": "pix",
"pixKey": "john.doe@example.com",
"pixKeyType": "email",
"holderName": "John Doe",
"currency": "BRL"
}
},
"relationships": [
{
"targetEntityId": "person-uuid-123",
"relationshipType": "owns",
"strength": 1.0
}
]
}'
const response = await fetch('http://api.gu1.ai/entities', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
entityType: 'payment_method',
entityData: {
paymentMethod: {
type: 'pix',
pixKey: 'john.doe@example.com',
pixKeyType: 'email',
holderName: 'John Doe',
currency: 'BRL'
}
},
relationships: [{
targetEntityId: 'person-uuid-123',
relationshipType: 'owns',
strength: 1.0
}]
})
});
response = requests.post(
'http://api.gu1.ai/entities',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'entityType': 'payment_method',
'entityData': {
'paymentMethod': {
'type': 'pix',
'pixKey': 'john.doe@example.com',
'pixKeyType': 'email',
'holderName': 'John Doe',
'currency': 'BRL'
}
},
'relationships': [{
'targetEntityId': 'person-uuid-123',
'relationshipType': 'owns',
'strength': 1.0
}]
}
)
Respuesta
boolean
Si la operación fue exitosa
string
UUID de la entidad de método de pago creada
string
Siempre
"payment_method"object
Los datos del método de pago tal como se almacenaron
array
Array de relaciones creadas
string
Marca de tiempo ISO 8601 de la creación
string
Marca de tiempo ISO 8601 de la última actualización
Ejemplo de Respuesta
{
"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"
}
},
"relationships": [
{
"targetEntityId": "person-uuid-123",
"relationshipType": "owns",
"strength": 1.0
}
],
"createdAt": "2024-12-23T10:00:00.000Z",
"updatedAt": "2024-12-23T10:00:00.000Z"
}
Respuestas de Error
400 Solicitud Incorrecta
{
"error": "Tipo de entidad inválido o campos requeridos faltantes",
"details": {
"entityType": "Debe ser 'payment_method'",
"entityData.paymentMethod.type": "Campo requerido"
}
}
401 No Autorizado
{
"error": "Clave API inválida o faltante"
}
Ver También
Was this page helpful?
⌘I