curl --request POST \
--url https://api.craqui.com/v1/payments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fee_id": "fee_01jq0h7v4dn2c9me4f8b5x3kwr",
"amount": {
"amount_cents": 360000,
"currency": "UYU"
},
"payment_method": "bank_transfer",
"paid_on": "2026-12-01",
"notes": "Transferencia BROU ref 8812"
}
'import requests
url = "https://api.craqui.com/v1/payments"
payload = {
"fee_id": "fee_01jq0h7v4dn2c9me4f8b5x3kwr",
"amount": {
"amount_cents": 360000,
"currency": "UYU"
},
"payment_method": "bank_transfer",
"paid_on": "2026-12-01",
"notes": "Transferencia BROU ref 8812"
}
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({
fee_id: 'fee_01jq0h7v4dn2c9me4f8b5x3kwr',
amount: {amount_cents: 360000, currency: 'UYU'},
payment_method: 'bank_transfer',
paid_on: '2026-12-01',
notes: 'Transferencia BROU ref 8812'
})
};
fetch('https://api.craqui.com/v1/payments', 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.craqui.com/v1/payments",
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([
'fee_id' => 'fee_01jq0h7v4dn2c9me4f8b5x3kwr',
'amount' => [
'amount_cents' => 360000,
'currency' => 'UYU'
],
'payment_method' => 'bank_transfer',
'paid_on' => '2026-12-01',
'notes' => 'Transferencia BROU ref 8812'
]),
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 := "https://api.craqui.com/v1/payments"
payload := strings.NewReader("{\n \"fee_id\": \"fee_01jq0h7v4dn2c9me4f8b5x3kwr\",\n \"amount\": {\n \"amount_cents\": 360000,\n \"currency\": \"UYU\"\n },\n \"payment_method\": \"bank_transfer\",\n \"paid_on\": \"2026-12-01\",\n \"notes\": \"Transferencia BROU ref 8812\"\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("https://api.craqui.com/v1/payments")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"fee_id\": \"fee_01jq0h7v4dn2c9me4f8b5x3kwr\",\n \"amount\": {\n \"amount_cents\": 360000,\n \"currency\": \"UYU\"\n },\n \"payment_method\": \"bank_transfer\",\n \"paid_on\": \"2026-12-01\",\n \"notes\": \"Transferencia BROU ref 8812\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.craqui.com/v1/payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"fee_id\": \"fee_01jq0h7v4dn2c9me4f8b5x3kwr\",\n \"amount\": {\n \"amount_cents\": 360000,\n \"currency\": \"UYU\"\n },\n \"payment_method\": \"bank_transfer\",\n \"paid_on\": \"2026-12-01\",\n \"notes\": \"Transferencia BROU ref 8812\"\n}"
response = http.request(request)
puts response.read_body{
"object": "preview",
"livemode": true,
"action": "payment.create",
"result": null,
"effects": {
"notifies_client": true,
"amount": {
"amount_cents": 360000,
"currency": "UYU"
},
"paid_on": "2026-12-01",
"fee_status_after": "paid_on_time",
"membership_activated": false,
"membership_reactivated": false,
"receipt": true,
"einvoice": true,
"notifications_not_suppressed": []
},
"warnings": [],
"summary": "Se registra el pago por el saldo de la cuota."
}{
"id": "pay_01jq0hq2bw6tx9a4v8m3dkc5zr",
"object": "payment",
"livemode": true,
"fee_id": "fee_01jq0h7v4dn2c9me4f8b5x3kwr",
"client_id": "cli_01jqy553dmxw6vmq7g5vzfa9yz",
"amount": {
"amount_cents": 360000,
"currency": "UYU"
},
"processor": "manual",
"method": "bank_transfer",
"paid_at": "2026-12-01T09:00:00-03:00",
"created_at": "2026-12-01T11:05:12-03:00",
"source": "api",
"effects": {
"receipt": "queued",
"einvoice": "queued"
},
"notifications_not_suppressed": []
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/revoked_api_key",
"title": "La clave fue revocada",
"status": 401,
"code": "revoked_api_key",
"detail": "Crea una clave nueva en Configuración → Integraciones.",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc"
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/sandbox_unavailable",
"title": "Tu estudio de prueba no está listo",
"status": 409,
"code": "sandbox_unavailable",
"detail": "Restablece tus datos de prueba en Configuración → Integraciones y vuelve a intentar.",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc"
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}Registrar un pago
Registra un pago que ya ocurrió fuera de Craqui (efectivo, transferencia, tarjeta en tu posnet), igual que
“Registrar pago” desde Craqui. La API nunca cobra: no llama a ningún procesador de pagos. El pago es siempre por
el saldo completo de la cuota: amount tiene que ser ese saldo, en la moneda del estudio y de la cuota; si no,
responde 409 amount_mismatch con expected_amount y no registra nada. Si el pago cae dentro de los días de
gracia, el saldo no lleva el recargo.
Después del pago se le manda el recibo al cliente (notify: false lo silencia, con notifications:suppress) y,
si el estudio emite la factura electrónica sola con cada pago, se emite: notify: false nunca la silencia, y
nunca sale dos veces para el mismo pago. Si el pago reactiva una membresía suspendida, al cliente le llega ese
aviso aunque mandes notify: false (notifications_not_suppressed). Responde 201 con el pago, source: api y
lo que se pidió después (effects). Con dry_run=true responde 200 con la vista previa.
Rechazos (409): fee_already_paid, fee_not_payable, fee_in_advance_payment, fee_under_automatic_debit
(la cobra el débito automático: no se registra a mano), amount_mismatch, fee_currency_missing y
business_currency_missing; 422 currency_mismatch y 422 paid_on_out_of_range. Una cuota que no es de tu
negocio responde 404 not_found.
Una escritura de plata: lleva Idempotency-Key (salvo con dry_run=true), solo para estudios (en una academia
responde wrong_vertical), solo si tu negocio tiene habilitada la escritura por la API (write_access_disabled
si no) y además las escrituras de plata (money_writes_not_enabled si no). Cuenta para el límite de escrituras
(30 por minuto) y para el de escrituras de plata (10 por minuto; una vista previa no cuenta para este). Un campo
que el cuerpo no declara responde validation_failed con unknown_field. Un reintento con la misma
Idempotency-Key, también después de las 24 horas, responde lo que ya se hizo, con Idempotent-Replayed: true.
curl --request POST \
--url https://api.craqui.com/v1/payments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fee_id": "fee_01jq0h7v4dn2c9me4f8b5x3kwr",
"amount": {
"amount_cents": 360000,
"currency": "UYU"
},
"payment_method": "bank_transfer",
"paid_on": "2026-12-01",
"notes": "Transferencia BROU ref 8812"
}
'import requests
url = "https://api.craqui.com/v1/payments"
payload = {
"fee_id": "fee_01jq0h7v4dn2c9me4f8b5x3kwr",
"amount": {
"amount_cents": 360000,
"currency": "UYU"
},
"payment_method": "bank_transfer",
"paid_on": "2026-12-01",
"notes": "Transferencia BROU ref 8812"
}
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({
fee_id: 'fee_01jq0h7v4dn2c9me4f8b5x3kwr',
amount: {amount_cents: 360000, currency: 'UYU'},
payment_method: 'bank_transfer',
paid_on: '2026-12-01',
notes: 'Transferencia BROU ref 8812'
})
};
fetch('https://api.craqui.com/v1/payments', 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.craqui.com/v1/payments",
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([
'fee_id' => 'fee_01jq0h7v4dn2c9me4f8b5x3kwr',
'amount' => [
'amount_cents' => 360000,
'currency' => 'UYU'
],
'payment_method' => 'bank_transfer',
'paid_on' => '2026-12-01',
'notes' => 'Transferencia BROU ref 8812'
]),
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 := "https://api.craqui.com/v1/payments"
payload := strings.NewReader("{\n \"fee_id\": \"fee_01jq0h7v4dn2c9me4f8b5x3kwr\",\n \"amount\": {\n \"amount_cents\": 360000,\n \"currency\": \"UYU\"\n },\n \"payment_method\": \"bank_transfer\",\n \"paid_on\": \"2026-12-01\",\n \"notes\": \"Transferencia BROU ref 8812\"\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("https://api.craqui.com/v1/payments")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"fee_id\": \"fee_01jq0h7v4dn2c9me4f8b5x3kwr\",\n \"amount\": {\n \"amount_cents\": 360000,\n \"currency\": \"UYU\"\n },\n \"payment_method\": \"bank_transfer\",\n \"paid_on\": \"2026-12-01\",\n \"notes\": \"Transferencia BROU ref 8812\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.craqui.com/v1/payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"fee_id\": \"fee_01jq0h7v4dn2c9me4f8b5x3kwr\",\n \"amount\": {\n \"amount_cents\": 360000,\n \"currency\": \"UYU\"\n },\n \"payment_method\": \"bank_transfer\",\n \"paid_on\": \"2026-12-01\",\n \"notes\": \"Transferencia BROU ref 8812\"\n}"
response = http.request(request)
puts response.read_body{
"object": "preview",
"livemode": true,
"action": "payment.create",
"result": null,
"effects": {
"notifies_client": true,
"amount": {
"amount_cents": 360000,
"currency": "UYU"
},
"paid_on": "2026-12-01",
"fee_status_after": "paid_on_time",
"membership_activated": false,
"membership_reactivated": false,
"receipt": true,
"einvoice": true,
"notifications_not_suppressed": []
},
"warnings": [],
"summary": "Se registra el pago por el saldo de la cuota."
}{
"id": "pay_01jq0hq2bw6tx9a4v8m3dkc5zr",
"object": "payment",
"livemode": true,
"fee_id": "fee_01jq0h7v4dn2c9me4f8b5x3kwr",
"client_id": "cli_01jqy553dmxw6vmq7g5vzfa9yz",
"amount": {
"amount_cents": 360000,
"currency": "UYU"
},
"processor": "manual",
"method": "bank_transfer",
"paid_at": "2026-12-01T09:00:00-03:00",
"created_at": "2026-12-01T11:05:12-03:00",
"source": "api",
"effects": {
"receipt": "queued",
"einvoice": "queued"
},
"notifications_not_suppressed": []
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/revoked_api_key",
"title": "La clave fue revocada",
"status": 401,
"code": "revoked_api_key",
"detail": "Crea una clave nueva en Configuración → Integraciones.",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc"
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/sandbox_unavailable",
"title": "Tu estudio de prueba no está listo",
"status": 409,
"code": "sandbox_unavailable",
"detail": "Restablece tus datos de prueba en Configuración → Integraciones y vuelve a intentar.",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc"
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}{
"type": "https://docs.craqui.com/errors/invalid_api_key",
"title": "La clave no es válida",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
"detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
"doc_url": "<string>",
"required_scope": "business:read",
"errors": [
{
"field": "limit",
"code": "invalid_limit",
"detail": "<string>"
}
],
"current_price": {
"amount_cents": 250000,
"currency": "UYU"
},
"expected_amount": {
"amount_cents": 250000,
"currency": "UYU"
},
"amount_at_stake": {
"amount_cents": 250000,
"currency": "UYU"
},
"existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
"booking_ids": [
"bkg_01jx9eak0437zdf0yw0atg7g0r"
]
}Authorizations
Clave del negocio. sk es una clave completa (todo lo que el rol de quien la creó puede dar)
y rk una restringida a los permisos que se eligieron al crearla. Solo se usa desde un
servidor: un pedido desde un navegador se rechaza con browser_not_allowed.
Scopes
Registrar pagos.
Headers
Versión de la API para este pedido (YYYY-MM-DD). Si no la mandas, se usa la versión fijada en
la clave cuando se creó.
^\d{4}-\d{2}-\d{2}$"2026-12-01"
Obligatorio en todo pedido que crea o cambia algo, salvo con dry_run=true. Un valor único por
operación (por ejemplo un UUID). Si repites el pedido con la misma clave y el mismo cuerpo dentro de 24
horas, recibes la misma respuesta (con el header Idempotent-Replayed: true) sin que se repita el efecto,
también la misma respuesta de error: para intentar de nuevo algo que se rechazó, usa una clave nueva.
Con un dry_run=true la clave se ignora y no se guarda: el pedido real puede usar la misma. Pasadas las 24
horas, repetir una reserva con la misma clave y el mismo cuerpo sigue devolviendo la reserva que se hizo
(como está ahora), y la misma clave con otro cuerpo responde idempotency_key_reused.
1 - 255Query Parameters
true para ver qué pasaría sin hacerlo: Craqui evalúa el pedido con las mismas reglas que el real y
responde 200 con un objeto preview, sin escribir nada ni avisarle a nadie. Cuenta para el límite de
escrituras. false (o sin el parámetro) hace el pedido real. Es el único parámetro de consulta de una
escritura.
Body
Id de una cuota.
^fee_[0-7][0-9a-hjkmnp-tv-z]{25}$"fee_01jxycdc0zf2nxw7n2azer6wqp"
El saldo completo de la cuota, en la moneda del estudio y de la cuota: un pago nunca es parcial ni se recorta
(409 amount_mismatch con expected_amount si no coincide). Si el pago cae dentro de los días de gracia, el
saldo no lleva el recargo.
Show child attributes
Show child attributes
Cómo pagó el cliente. La API registra pagos que ya ocurrieron: nunca cobra.
cash, bank_transfer, debit_card, credit_card, check, other El día del pago en el calendario del estudio, de hoy a 90 días atrás. Por defecto, hoy.
^\d{4}-\d{2}-\d{2}$"2026-12-02"
Una nota para el estudio (por ejemplo, la referencia de la transferencia).
500false para no enviarle al cliente los avisos de esta escritura (email, WhatsApp). Necesita el permiso
notifications:suppress; sin él, la respuesta es 403 scope_required. Nunca silencia el aviso a otra
persona: si una cancelación hace entrar a alguien de la lista de espera, esa persona se entera igual. Los
recordatorios posteriores salen igual. Por defecto true. Tu estudio de prueba no le avisa a nadie,
diga lo que diga este campo.
Response
Con dry_run=true, la vista previa (no se escribió nada).
Lo que haría la escritura de plata, sin hacerla: Craqui corre la misma operación que el pedido real y la
deshace, así que una vista previa que se rechazaría responde el mismo error (por ejemplo price_changed o
amount_mismatch, con el monto de hoy). No consume la Idempotency-Key ni cuenta para el límite de escrituras
de plata.
"preview"false si la vista previa es de tu estudio de prueba (claves crq_test_); true con claves crq_live_.
credit_grant.create, credit_grant.revoke, membership.create, membership.cancel, membership.freeze,
membership.unfreeze o payment.create. La lista puede crecer.
credit_grant.create, credit_grant.revoke, membership.create, membership.cancel, membership.freeze, membership.unfreeze, payment.create El objeto como está hoy; null si la escritura lo crearía.
- Option 1
- Option 2
Show child attributes
Show child attributes
Lo que pasaría con la plata, los créditos y los avisos. Cada acción trae sus campos.
Show child attributes
Show child attributes
no_change (la baja ya estaba programada: el pedido real no cambia nada). La lista puede crecer.
no_change Lo mismo en una frase en español, para mostrarle a una persona. No nombra al cliente.