curl --request POST \
--url https://api.craqui.com/v1/memberships \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"client_id": "cli_01je0mdfx4f3gr5peqyzsj0v2g",
"membership_plan_id": "mpl_01jt05nvk11xa1zm1pwve2qj7r",
"start_option": null,
"first_fee": {
"amount_cents": 250000,
"currency": "UYU"
}
}
'import requests
url = "https://api.craqui.com/v1/memberships"
payload = {
"client_id": "cli_01je0mdfx4f3gr5peqyzsj0v2g",
"membership_plan_id": "mpl_01jt05nvk11xa1zm1pwve2qj7r",
"start_option": None,
"first_fee": {
"amount_cents": 250000,
"currency": "UYU"
}
}
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({
client_id: 'cli_01je0mdfx4f3gr5peqyzsj0v2g',
membership_plan_id: 'mpl_01jt05nvk11xa1zm1pwve2qj7r',
start_option: null,
first_fee: {amount_cents: 250000, currency: 'UYU'}
})
};
fetch('https://api.craqui.com/v1/memberships', 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/memberships",
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([
'client_id' => 'cli_01je0mdfx4f3gr5peqyzsj0v2g',
'membership_plan_id' => 'mpl_01jt05nvk11xa1zm1pwve2qj7r',
'start_option' => null,
'first_fee' => [
'amount_cents' => 250000,
'currency' => 'UYU'
]
]),
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/memberships"
payload := strings.NewReader("{\n \"client_id\": \"cli_01je0mdfx4f3gr5peqyzsj0v2g\",\n \"membership_plan_id\": \"mpl_01jt05nvk11xa1zm1pwve2qj7r\",\n \"start_option\": null,\n \"first_fee\": {\n \"amount_cents\": 250000,\n \"currency\": \"UYU\"\n }\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/memberships")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"client_id\": \"cli_01je0mdfx4f3gr5peqyzsj0v2g\",\n \"membership_plan_id\": \"mpl_01jt05nvk11xa1zm1pwve2qj7r\",\n \"start_option\": null,\n \"first_fee\": {\n \"amount_cents\": 250000,\n \"currency\": \"UYU\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.craqui.com/v1/memberships")
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 \"client_id\": \"cli_01je0mdfx4f3gr5peqyzsj0v2g\",\n \"membership_plan_id\": \"mpl_01jt05nvk11xa1zm1pwve2qj7r\",\n \"start_option\": null,\n \"first_fee\": {\n \"amount_cents\": 250000,\n \"currency\": \"UYU\"\n }\n}"
response = http.request(request)
puts response.read_body{
"object": "preview",
"livemode": true,
"action": "membership.create",
"result": null,
"effects": {
"notifies_client": true,
"status": "active",
"credits_added": 8,
"period_start": "2026-12-01",
"period_end": "2027-01-01",
"first_fee": {
"amount_cents": 250000,
"currency": "UYU"
},
"first_fee_due_date": "2026-12-01",
"next_fee": null
},
"warnings": [],
"summary": "Se asigna la membresía y queda su primera cuota para cobrar."
}{
"id": "mem_01jq0j5c8vt3ka7xe2n9wfb4dm",
"object": "membership",
"livemode": true,
"client_id": "cli_01je0mdfx4f3gr5peqyzsj0v2g",
"membership_plan_id": "mpl_01jt05nvk11xa1zm1pwve2qj7r",
"status": "active",
"current_period_start": "2026-12-01T00:00:00-03:00",
"current_period_end": "2027-01-01T00:00:00-03:00",
"renews_at": "2027-01-01T00:00:00-03:00",
"next_credit_date": "2027-01-01",
"started_at": "2026-12-01T00:00:00-03:00",
"cancelled_at": null,
"suspension_reason": null,
"discount": null,
"active_freeze_id": null,
"created_at": "2026-12-01T11:10:31-03:00",
"updated_at": "2026-12-01T11:10:31-03:00",
"first_fee_id": "fee_01jq0j5d2k7rwb4c9tx6mzn3ha",
"next_fee_id": null
}{
"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"
]
}Asignar una membresía ya vendida
Asigna a un cliente una membresía que vendiste fuera de Craqui, igual que “Asignar membresía” desde Craqui: abre su
primer período, carga sus créditos y crea su primera cuota, para registrar el pago con POST /v1/payments. La
API no cobra y la membresía empieza hoy (o, en un estudio que renueva todas el mismo día, como diga
start_option).
first_fee es obligatorio aunque sea 0: tiene que ser la primera cuota que Craqui calcula hoy para ese plan, en
la moneda del estudio; si no, responde 409 price_changed con current_price y no asigna nada. Al cliente le
llega el aviso de siempre (notify: false lo silencia, con notifications:suppress). Responde 201 con la
membresía, su first_fee_id y, si el estudio emite por adelantado la cuota siguiente, su next_fee_id. Con
dry_run=true responde 200 con la vista previa: período, créditos y cuotas.
Rechazos (409): active_membership_exists, membership_suspended, membership_paused y
membership_scheduled (con existing_membership_id), membership_plan_inactive, client_inactive y
business_currency_missing; 422 start_option_not_applicable y 422 currency_mismatch. Un cliente o un plan que
no es de tu negocio responde 404 not_found. Un reintento con la misma Idempotency-Key nunca crea una segunda
membresía ni una segunda cuota, aunque la primera ya haya terminado.
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/memberships \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"client_id": "cli_01je0mdfx4f3gr5peqyzsj0v2g",
"membership_plan_id": "mpl_01jt05nvk11xa1zm1pwve2qj7r",
"start_option": null,
"first_fee": {
"amount_cents": 250000,
"currency": "UYU"
}
}
'import requests
url = "https://api.craqui.com/v1/memberships"
payload = {
"client_id": "cli_01je0mdfx4f3gr5peqyzsj0v2g",
"membership_plan_id": "mpl_01jt05nvk11xa1zm1pwve2qj7r",
"start_option": None,
"first_fee": {
"amount_cents": 250000,
"currency": "UYU"
}
}
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({
client_id: 'cli_01je0mdfx4f3gr5peqyzsj0v2g',
membership_plan_id: 'mpl_01jt05nvk11xa1zm1pwve2qj7r',
start_option: null,
first_fee: {amount_cents: 250000, currency: 'UYU'}
})
};
fetch('https://api.craqui.com/v1/memberships', 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/memberships",
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([
'client_id' => 'cli_01je0mdfx4f3gr5peqyzsj0v2g',
'membership_plan_id' => 'mpl_01jt05nvk11xa1zm1pwve2qj7r',
'start_option' => null,
'first_fee' => [
'amount_cents' => 250000,
'currency' => 'UYU'
]
]),
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/memberships"
payload := strings.NewReader("{\n \"client_id\": \"cli_01je0mdfx4f3gr5peqyzsj0v2g\",\n \"membership_plan_id\": \"mpl_01jt05nvk11xa1zm1pwve2qj7r\",\n \"start_option\": null,\n \"first_fee\": {\n \"amount_cents\": 250000,\n \"currency\": \"UYU\"\n }\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/memberships")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"client_id\": \"cli_01je0mdfx4f3gr5peqyzsj0v2g\",\n \"membership_plan_id\": \"mpl_01jt05nvk11xa1zm1pwve2qj7r\",\n \"start_option\": null,\n \"first_fee\": {\n \"amount_cents\": 250000,\n \"currency\": \"UYU\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.craqui.com/v1/memberships")
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 \"client_id\": \"cli_01je0mdfx4f3gr5peqyzsj0v2g\",\n \"membership_plan_id\": \"mpl_01jt05nvk11xa1zm1pwve2qj7r\",\n \"start_option\": null,\n \"first_fee\": {\n \"amount_cents\": 250000,\n \"currency\": \"UYU\"\n }\n}"
response = http.request(request)
puts response.read_body{
"object": "preview",
"livemode": true,
"action": "membership.create",
"result": null,
"effects": {
"notifies_client": true,
"status": "active",
"credits_added": 8,
"period_start": "2026-12-01",
"period_end": "2027-01-01",
"first_fee": {
"amount_cents": 250000,
"currency": "UYU"
},
"first_fee_due_date": "2026-12-01",
"next_fee": null
},
"warnings": [],
"summary": "Se asigna la membresía y queda su primera cuota para cobrar."
}{
"id": "mem_01jq0j5c8vt3ka7xe2n9wfb4dm",
"object": "membership",
"livemode": true,
"client_id": "cli_01je0mdfx4f3gr5peqyzsj0v2g",
"membership_plan_id": "mpl_01jt05nvk11xa1zm1pwve2qj7r",
"status": "active",
"current_period_start": "2026-12-01T00:00:00-03:00",
"current_period_end": "2027-01-01T00:00:00-03:00",
"renews_at": "2027-01-01T00:00:00-03:00",
"next_credit_date": "2027-01-01",
"started_at": "2026-12-01T00:00:00-03:00",
"cancelled_at": null,
"suspension_reason": null,
"discount": null,
"active_freeze_id": null,
"created_at": "2026-12-01T11:10:31-03:00",
"updated_at": "2026-12-01T11:10:31-03:00",
"first_fee_id": "fee_01jq0j5d2k7rwb4c9tx6mzn3ha",
"next_fee_id": null
}{
"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
Asignar, cancelar, congelar y descongelar membresías.
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 un cliente del estudio.
^cli_[0-7][0-9a-hjkmnp-tv-z]{25}$"cli_01jatfha5h4nkg77c3wfrvd3cw"
Id de un plan de membresía.
^mpl_[0-7][0-9a-hjkmnp-tv-z]{25}$"mpl_01jt05nvk11xa1zm1pwve2qj7r"
La primera cuota que cobraste, también si es 0: tiene que ser la que Craqui calcula hoy para ese plan y esa
opción de inicio (409 price_changed con current_price si no). Así una membresía nunca se asigna a un
precio que tu checkout no cobró.
Show child attributes
Show child attributes
Solo en un estudio que renueva todas las membresías el mismo día, para quien empieza a mitad de mes:
next_cycle (empieza el próximo día de renovación), prorate (paga los días que quedan) o full_credits
(todos los créditos ahora, precio completo). En cualquier otro estudio, null (422 start_option_not_applicable si no).
next_cycle, prorate, full_credits, null false 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.