Créditos, pagos y facturación

28 operaciones, cada una con sus parámetros, ejemplos en curl y TypeScript listos para copiar y sus errores.

Las operaciones marcadas /v1 se autentican con un token de agente; las demás, con una sesión del panel. Cómo funcionan ambas está en Autenticación

`checkoutPayer`

GET/_x/query/checkout-payer

Miembro de la firmaPermiso: billing:purchase

checkoutPayer

Parámetros de checkoutPayer
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/checkout-payer?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/checkout-payer?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`checkoutTerms`

GET/_x/query/checkout-terms

Miembro de la firmaPermiso: billing:purchase

checkoutTerms

Parámetros de checkoutTerms
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/checkout-terms?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/checkout-terms?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`creditsBalance`

GET/v1/credits-balance

Miembro de la firmaPermiso: billing:read/v1 · token BearerHerramienta MCP: creditsBalance

Credits left: one per recipient, used on send. mode free = trial only: never tell the lawyer to buy.

Parámetros de creditsBalance
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/credits-balance?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/credits-balance?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`ledgerList`

GET/v1/ledger-list

Miembro de la firmaPermiso: billing:read/v1 · token BearerHerramienta MCP: ledgerList

The credit statement: grants, consumes, expiries and corrections, newest first.

Parámetros de ledgerList
Nombre	Dónde	Tipo	Obligatorio
`cursor`	Consulta	`string 1–64`	No
`limit`	Consulta	`integer 1–501`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/ledger-list?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/ledger-list?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`listMyInvoices`

GET/v1/list-my-invoices

Miembro de la firmaPermiso: invoicing:read/v1 · token BearerHerramienta MCP: listMyInvoices

The firm's DIAN invoices, newest first, with status and amounts (COP minor units).

Parámetros de listMyInvoices
Nombre	Dónde	Tipo	Obligatorio
`limit`	Consulta	`integer 1–200`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/list-my-invoices?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/list-my-invoices?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`listMyPayments`

GET/_x/query/list-my-payments

Miembro de la firmaPermiso: payment:read

listMyPayments

Parámetros de listMyPayments
Nombre	Dónde	Tipo	Obligatorio
`limit`	Consulta	`integer 1–200`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/list-my-payments?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/list-my-payments?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`myBillingProfile`

GET/_x/query/my-billing-profile

Miembro de la firmaPermiso: payment:read

myBillingProfile

Parámetros de myBillingProfile
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/my-billing-profile?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/my-billing-profile?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`mySubscription`

GET/_x/query/my-subscription

Miembro de la firmaPermiso: payment:read

mySubscription

Parámetros de mySubscription
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/my-subscription?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/my-subscription?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`nequiSourceStatus`

GET/_x/query/nequi-source-status

Miembro de la firmaPermiso: payment:read

nequiSourceStatus

Parámetros de nequiSourceStatus
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`sourceId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/nequi-source-status?orgId=<orgId>&sourceId=<sourceId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/nequi-source-status?orgId=<orgId>&sourceId=<sourceId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`packOffers`

GET/_x/query/pack-offers

Miembro de la firmaPermiso: payment:read

packOffers

Parámetros de packOffers
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/pack-offers?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/pack-offers?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`paymentStatus`

GET/_x/query/payment-status

Miembro de la firmaPermiso: payment:read

paymentStatus

Parámetros de paymentStatus
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`paymentId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/payment-status?orgId=<orgId>&paymentId=<paymentId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/payment-status?orgId=<orgId>&paymentId=<paymentId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`planOffers`

GET/_x/query/plan-offers

Miembro de la firmaPermiso: payment:read

planOffers

Parámetros de planOffers
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/plan-offers?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/plan-offers?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`cancelSubscription`

POST/api/cancel-subscription

Miembro de la firmaPermiso: billing:purchase

cancelSubscription

Parámetros de cancelSubscription
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/cancel-subscription' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/cancel-subscription', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "cancelAtPeriodEnd": true,
  "collection": "auto",
  "currentPeriodEnd": "2026-09-25T15:00:00Z",
  "currentPeriodStart": "2026-09-25T15:00:00Z",
  "endedAt": "2026-09-25T15:00:00Z",
  "freeCyclesPending": -9007199254740991,
  "id": "<id>",
  "interval": "month",
  "planId": "<planId>",
  "status": "trialing"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`changePlan`

POST/api/change-plan

Miembro de la firmaPermiso: billing:purchaseIdempotency-Key

changePlan

Parámetros de changePlan
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`interval`	Cuerpo	`"month" \| "year"`	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`planCode`	Cuerpo	`string 1–40`	Sí

curl

curl -X POST 'https://www.notificado.co/api/change-plan' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>","planCode":"<planCode>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/change-plan', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID(), origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>",
    "planCode": "<planCode>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "change": "upgraded",
  "checkout": {
    "action": "<action>",
    "fields": {},
    "method": "GET"
  },
  "effectiveAt": "2026-09-25T15:00:00Z",
  "payment": {
    "amountGross": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountIva": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountNet": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "approvedAt": "2026-09-25T15:00:00Z",
    "createdAt": "2026-09-25T15:00:00Z",
    "discount": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "id": "<id>",
    "method": "CARD",
    "purpose": "pack",
    "reference": "<reference>",
    "status": "created",
    "statusAt": "2026-09-25T15:00:00Z",
    "subjectId": "<subjectId>"
  }
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`confirmPaymentReturn`

POST/api/confirm-payment-return

Miembro de la firmaPermiso: billing:purchase

confirmPaymentReturn

Parámetros de confirmPaymentReturn
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Cuerpo	`string (uuid)`	Sí
`transactionId`	Cuerpo	`string 1–64`	Sí

curl

curl -X POST 'https://www.notificado.co/api/confirm-payment-return' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>","transactionId":"<transactionId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/confirm-payment-return', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>",
    "transactionId": "<transactionId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "asyncPaymentUrl": "<asyncPaymentUrl>",
  "payment": {
    "amountGross": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountIva": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountNet": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "approvedAt": "2026-09-25T15:00:00Z",
    "createdAt": "2026-09-25T15:00:00Z",
    "discount": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "id": "<id>",
    "method": "CARD",
    "purpose": "pack",
    "reference": "<reference>",
    "status": "created",
    "statusAt": "2026-09-25T15:00:00Z",
    "subjectId": "<subjectId>"
  }
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`downloadInvoice`

POST/v1/download-invoice

Miembro de la firmaPermiso: invoicing:read/v1 · token BearerHerramienta MCP: downloadInvoice

An invoice or credit note as pdf or xml bytes (base64). Recorded.

Parámetros de downloadInvoice
Nombre	Dónde	Tipo	Obligatorio
`creditNoteId`	Cuerpo	`string (uuid)`	No
`format`	Cuerpo	`"pdf" \| "xml"`	Sí
`invoiceId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/v1/download-invoice' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"format":"pdf","invoiceId":"<invoiceId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/download-invoice', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "format": "pdf",
    "invoiceId": "<invoiceId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "bytes": 0,
  "contentBase64": "<contentBase64>",
  "contentType": "<contentType>",
  "filename": "<filename>",
  "format": "pdf",
  "number": "<number>",
  "sha256": "<sha256>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`getReferralLink`

POST/api/get-referral-link

Miembro de la firmaPermiso: billing:readHerramienta MCP: getReferralLink

Returns the caller's firm's customer-referral link (https://www.notificado.co/registro?ref=O-XXXXXXXX) and its code, creating the code on first call. A firm that signs up through the link and makes its first payment earns the caller's firm one free month (a free subscription cycle, or 40 credits without a subscription) after a 30-day hold without refund. Needs billing:read in the given orgId.

Parámetros de getReferralLink
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/get-referral-link' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/get-referral-link', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "code": "<code>",
  "url": "<url>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`lookupTaxId`

POST/api/lookup-tax-id

Miembro de la firmaPermiso: billing:purchase

lookupTaxId

Parámetros de lookupTaxId
Nombre	Dónde	Tipo	Obligatorio
`dv`	Cuerpo	`string`	No
`number`	Cuerpo	`string 5–10`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/lookup-tax-id' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"number":"<number>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/lookup-tax-id', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "number": "<number>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "chamber": "<chamber>",
  "dvMatches": true,
  "found": true,
  "name": "<name>",
  "source": "rues-open-data",
  "status": "active",
  "statusText": "<statusText>",
  "updatedAt": "<updatedAt>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`payCycle`

POST/api/pay-cycle

Miembro de la firmaPermiso: billing:purchaseIdempotency-Key

payCycle

Parámetros de payCycle
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`cycleId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`overage`	Cuerpo	`boolean`	No

curl

curl -X POST 'https://www.notificado.co/api/pay-cycle' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{"cycleId":"<cycleId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/pay-cycle', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID(), origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "cycleId": "<cycleId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "checkout": {
    "action": "<action>",
    "fields": {},
    "method": "GET"
  },
  "payment": {
    "amountGross": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountIva": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountNet": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "approvedAt": "2026-09-25T15:00:00Z",
    "createdAt": "2026-09-25T15:00:00Z",
    "discount": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "id": "<id>",
    "method": "CARD",
    "purpose": "pack",
    "reference": "<reference>",
    "status": "created",
    "statusAt": "2026-09-25T15:00:00Z",
    "subjectId": "<subjectId>"
  }
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`previewCoupon`

POST/api/preview-coupon

Miembro de la firmaPermiso: billing:read

previewCoupon

Parámetros de previewCoupon
Nombre	Dónde	Tipo	Obligatorio
`code`	Cuerpo	`string 1–40`	Sí
`interval`	Cuerpo	`"month" \| "year"`	No
`kind`	Cuerpo	`"pack" \| "plan"`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`subjectCode`	Cuerpo	`string 1–40`	Sí

curl

curl -X POST 'https://www.notificado.co/api/preview-coupon' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{
  "code": "<code>",
  "kind": "pack",
  "orgId": "<orgId>",
  "subjectCode": "<subjectCode>"
}'

TypeScript

const response = await fetch('https://www.notificado.co/api/preview-coupon', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "code": "<code>",
    "kind": "pack",
    "orgId": "<orgId>",
    "subjectCode": "<subjectCode>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "coupon": {
    "amountOff": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "appliesTo": "pack",
    "code": "<code>",
    "cycles": -9007199254740991,
    "duration": "once",
    "kind": "percent",
    "percentBps": -9007199254740991,
    "validTo": "2026-09-25T15:00:00Z"
  },
  "discount": {
    "currency": "<currency>",
    "minor": -9007199254740991,
    "scale": 0
  },
  "gross": {
    "currency": "<currency>",
    "minor": -9007199254740991,
    "scale": 0
  },
  "iva": {
    "currency": "<currency>",
    "minor": -9007199254740991,
    "scale": 0
  },
  "net": {
    "currency": "<currency>",
    "minor": -9007199254740991,
    "scale": 0
  }
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`refreshPayment`

POST/api/refresh-payment

Miembro de la firmaPermiso: billing:purchase

refreshPayment

Parámetros de refreshPayment
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Cuerpo	`string (uuid)`	Sí
`paymentId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/refresh-payment' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>","paymentId":"<paymentId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/refresh-payment', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>",
    "paymentId": "<paymentId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "asyncPaymentUrl": "<asyncPaymentUrl>",
  "payment": {
    "amountGross": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountIva": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountNet": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "approvedAt": "2026-09-25T15:00:00Z",
    "createdAt": "2026-09-25T15:00:00Z",
    "discount": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "id": "<id>",
    "method": "CARD",
    "purpose": "pack",
    "reference": "<reference>",
    "status": "created",
    "statusAt": "2026-09-25T15:00:00Z",
    "subjectId": "<subjectId>"
  }
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`registerPaymentSource`

POST/api/register-payment-source

Miembro de la firmaPermiso: billing:purchaseIdempotency-Key

registerPaymentSource

Parámetros de registerPaymentSource
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`source`	Cuerpo	`object \| object`	Sí
`terms`	Cuerpo	`object`	Sí
`useForSubscription`	Cuerpo	`boolean`	No

curl

curl -X POST 'https://www.notificado.co/api/register-payment-source' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{
  "orgId": "<orgId>",
  "source": {
    "token": "<token>",
    "type": "CARD"
  },
  "terms": {
    "acceptanceToken": "<acceptanceToken>",
    "personalDataToken": "<personalDataToken>"
  }
}'

TypeScript

const response = await fetch('https://www.notificado.co/api/register-payment-source', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID(), origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>",
    "source": {
      "token": "<token>",
      "type": "CARD"
    },
    "terms": {
      "acceptanceToken": "<acceptanceToken>",
      "personalDataToken": "<personalDataToken>"
    }
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "id": "<id>",
  "label": "<label>",
  "status": "<status>",
  "type": "<type>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`resumeSubscription`

POST/api/resume-subscription

Miembro de la firmaPermiso: billing:purchase

resumeSubscription

Parámetros de resumeSubscription
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/resume-subscription' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/resume-subscription', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "cancelAtPeriodEnd": true,
  "collection": "auto",
  "currentPeriodEnd": "2026-09-25T15:00:00Z",
  "currentPeriodStart": "2026-09-25T15:00:00Z",
  "endedAt": "2026-09-25T15:00:00Z",
  "freeCyclesPending": -9007199254740991,
  "id": "<id>",
  "interval": "month",
  "planId": "<planId>",
  "status": "trialing"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`saveBillingProfile`

POST/api/save-billing-profile

Miembro de la firmaPermiso: billing:purchase

saveBillingProfile

Parámetros de saveBillingProfile
Nombre	Dónde	Tipo	Obligatorio
`aceptoEstadoInactivo`	Cuerpo	`boolean \| "" \| string 1–8`	No
`acknowledgeInactiveRegistry`	Cuerpo	`boolean`	No
`address`	Cuerpo	`"" \| string 1–200`	No
`cityCode`	Cuerpo	`"" \| string 1–120`	No
`docNumber`	Cuerpo	`"" \| string 3–20`	No
`docType`	Cuerpo	`"" \| "CC" \| "NIT" \| "CE" \| "PP"`	No
`dv`	Cuerpo	`"" \| string 1–1 \| null`	No
`email`	Cuerpo	`"" \| string (email) ≤ 254`	No
`familyNames`	Cuerpo	`"" \| string 1–100 \| null`	No
`fiscalResponsibilities`	Cuerpo	`array of string 1–12 \| "" \| string 1–200`	No
`givenNames`	Cuerpo	`"" \| string 1–100 \| null`	No
`invoiceTo`	Cuerpo	`"" \| "self" \| "final_consumer"`	No
`legalName`	Cuerpo	`"" \| string 1–200`	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`phone`	Cuerpo	`"" \| string 1–40 \| null`	No
`returnTo`	Cuerpo	`string 1–240`	No
`taxRegime`	Cuerpo	`"" \| "responsable_iva" \| "no_responsable_iva"`	No

curl

curl -X POST 'https://www.notificado.co/api/save-billing-profile' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/save-billing-profile', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "address": "<address>",
  "cityCode": "<cityCode>",
  "docNumber": "<docNumber>",
  "docType": "CC",
  "dv": "<dv>",
  "email": "<email>",
  "fiscalResponsibilities": [
    "<fiscalResponsibilities>"
  ],
  "invoiceTo": "self",
  "legalName": "<legalName>",
  "taxRegime": "responsable_iva",
  "updatedAt": "2026-09-25T15:00:00Z"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`startPackCheckout`

POST/api/start-pack-checkout

Miembro de la firmaPermiso: billing:purchaseIdempotency-Key

startPackCheckout

Parámetros de startPackCheckout
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`acknowledgeInactiveRegistry`	Cuerpo	`boolean`	No
`billingProfile`	Cuerpo	`object`	No
`captchaToken`	Cuerpo	`string 0–4096`	No
`cf-turnstile-response`	Cuerpo	`string 0–4096`	No
`couponCode`	Cuerpo	`string 1–40`	No
`h-captcha-response`	Cuerpo	`string 0–4096`	No
`invoiceTo`	Cuerpo	`"self" \| "final_consumer"`	No
`method`	Cuerpo	`object \| object \| object \| object`	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`packCode`	Cuerpo	`string 1–40`	Sí
`payerName`	Cuerpo	`string 1–200`	No
`payerPhone`	Cuerpo	`string 10–15`	No
`terms`	Cuerpo	`object`	No

curl

curl -X POST 'https://www.notificado.co/api/start-pack-checkout' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>","packCode":"<packCode>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/start-pack-checkout', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID(), origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>",
    "packCode": "<packCode>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "asyncPaymentUrl": "<asyncPaymentUrl>",
  "checkout": {
    "action": "<action>",
    "fields": {},
    "method": "GET"
  },
  "payment": {
    "amountGross": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountIva": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountNet": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "approvedAt": "2026-09-25T15:00:00Z",
    "createdAt": "2026-09-25T15:00:00Z",
    "discount": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "id": "<id>",
    "method": "CARD",
    "purpose": "pack",
    "reference": "<reference>",
    "status": "created",
    "statusAt": "2026-09-25T15:00:00Z",
    "subjectId": "<subjectId>"
  },
  "transactionId": "<transactionId>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`submitPackPurchase`

POST/api/submit-pack-purchase

Miembro de la firmaPermiso: billing:purchaseIdempotency-Key

submitPackPurchase

Parámetros de submitPackPurchase
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`aceptaDatos`	Cuerpo	`boolean \| "" \| string 1–8`	No
`aceptaTerminos`	Cuerpo	`boolean \| "" \| string 1–8`	No
`aceptoEstadoInactivo`	Cuerpo	`boolean \| "" \| string 1–8`	No
`address`	Cuerpo	`"" \| string 1–200`	No
`captchaToken`	Cuerpo	`string 0–4096`	No
`celular`	Cuerpo	`"" \| string 1–24`	No
`cf-turnstile-response`	Cuerpo	`string 0–4096`	No
`cityCode`	Cuerpo	`"" \| string 1–120`	No
`cupon`	Cuerpo	`"" \| string 1–80`	No
`docNumber`	Cuerpo	`"" \| string 3–20`	No
`docType`	Cuerpo	`"" \| "CC" \| "NIT" \| "CE" \| "PP"`	No
`dv`	Cuerpo	`"" \| string 1–1 \| null`	No
`email`	Cuerpo	`"" \| string (email) ≤ 254`	No
`familyNames`	Cuerpo	`"" \| string 1–100 \| null`	No
`fiscalResponsibilities`	Cuerpo	`array of string 1–12 \| "" \| string 1–200`	No
`givenNames`	Cuerpo	`"" \| string 1–100 \| null`	No
`h-captcha-response`	Cuerpo	`string 0–4096`	No
`intent`	Cuerpo	`"" \| string 1–40`	No
`invoiceTo`	Cuerpo	`"" \| "self" \| "final_consumer"`	No
`legalName`	Cuerpo	`"" \| string 1–200`	No
`metodo`	Cuerpo	`"" \| string 1–40`	No
`nonce`	Cuerpo	`string (uuid)`	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`pack`	Cuerpo	`"" \| string 1–40`	No
`phone`	Cuerpo	`"" \| string 1–40 \| null`	No
`taxRegime`	Cuerpo	`"" \| "responsable_iva" \| "no_responsable_iva"`	No

curl

curl -X POST 'https://www.notificado.co/api/submit-pack-purchase' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/submit-pack-purchase', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID(), origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "location": "<location>",
  "paymentId": "<paymentId>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`submitSubscription`

POST/api/submit-subscription

Miembro de la firmaPermiso: billing:purchaseIdempotency-Key

submitSubscription

Parámetros de submitSubscription
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`aceptoEstadoInactivo`	Cuerpo	`boolean \| "" \| string 1–8`	No
`address`	Cuerpo	`"" \| string 1–200`	No
`cityCode`	Cuerpo	`"" \| string 1–120`	No
`cobro`	Cuerpo	`"" \| string 1–10`	No
`cupon`	Cuerpo	`"" \| string 1–80`	No
`docNumber`	Cuerpo	`"" \| string 3–20`	No
`docType`	Cuerpo	`"" \| "CC" \| "NIT" \| "CE" \| "PP"`	No
`dv`	Cuerpo	`"" \| string 1–1 \| null`	No
`email`	Cuerpo	`"" \| string (email) ≤ 254`	No
`familyNames`	Cuerpo	`"" \| string 1–100 \| null`	No
`fiscalResponsibilities`	Cuerpo	`array of string 1–12 \| "" \| string 1–200`	No
`fuente`	Cuerpo	`"" \| string 1–40`	No
`givenNames`	Cuerpo	`"" \| string 1–100 \| null`	No
`intent`	Cuerpo	`"" \| string 1–40`	No
`interval`	Cuerpo	`"" \| string 1–10`	No
`invoiceTo`	Cuerpo	`"" \| "self" \| "final_consumer"`	No
`legalName`	Cuerpo	`"" \| string 1–200`	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`phone`	Cuerpo	`"" \| string 1–40 \| null`	No
`plan`	Cuerpo	`"" \| string 1–40`	No
`taxRegime`	Cuerpo	`"" \| "responsable_iva" \| "no_responsable_iva"`	No

curl

curl -X POST 'https://www.notificado.co/api/submit-subscription' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/submit-subscription', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID(), origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "location": "<location>",
  "subscriptionId": "<subscriptionId>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

POST/api/subscribe

Miembro de la firmaPermiso: billing:purchaseIdempotency-Key

Parámetros de subscribe
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`billingProfile`	Cuerpo	`object`	No
`collection`	Cuerpo	`"auto" \| "link"`	Sí
`couponCode`	Cuerpo	`string 1–40`	No
`interval`	Cuerpo	`"month" \| "year"`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`paymentSourceId`	Cuerpo	`string (uuid)`	No
`planCode`	Cuerpo	`string 1–40`	Sí

curl

curl -X POST 'https://www.notificado.co/api/subscribe' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{
  "collection": "auto",
  "interval": "month",
  "orgId": "<orgId>",
  "planCode": "<planCode>"
}'

TypeScript

const response = await fetch('https://www.notificado.co/api/subscribe', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID(), origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "collection": "auto",
    "interval": "month",
    "orgId": "<orgId>",
    "planCode": "<planCode>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "checkout": {
    "action": "<action>",
    "fields": {},
    "method": "GET"
  },
  "cycle": {
    "amountGross": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountIva": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountNet": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "attempts": -9007199254740991,
    "discount": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "id": "<id>",
    "nextAttemptAt": "2026-09-25T15:00:00Z",
    "periodEnd": "2026-09-25T15:00:00Z",
    "periodStart": "2026-09-25T15:00:00Z",
    "status": "due",
    "subscriptionId": "<subscriptionId>"
  },
  "payment": {
    "amountGross": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountIva": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "amountNet": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "approvedAt": "2026-09-25T15:00:00Z",
    "createdAt": "2026-09-25T15:00:00Z",
    "discount": {
      "currency": "<currency>",
      "minor": -9007199254740991,
      "scale": 0
    },
    "id": "<id>",
    "method": "CARD",
    "purpose": "pack",
    "reference": "<reference>",
    "status": "created",
    "statusAt": "2026-09-25T15:00:00Z",
    "subjectId": "<subjectId>"
  },
  "subscription": {
    "cancelAtPeriodEnd": true,
    "collection": "auto",
    "currentPeriodEnd": "2026-09-25T15:00:00Z",
    "currentPeriodStart": "2026-09-25T15:00:00Z",
    "endedAt": "2026-09-25T15:00:00Z",
    "freeCyclesPending": -9007199254740991,
    "id": "<id>",
    "interval": "month",
    "planId": "<planId>",
    "status": "trialing"
  }
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

Preferencias

Idioma

Apariencia

Créditos, pagos y facturación

`checkoutPayer`

`checkoutTerms`

`creditsBalance`

`ledgerList`

`listMyInvoices`

`listMyPayments`

`myBillingProfile`

`mySubscription`

`nequiSourceStatus`

`packOffers`

`paymentStatus`

`planOffers`

`cancelSubscription`

`changePlan`

`confirmPaymentReturn`

`downloadInvoice`

`getReferralLink`

`lookupTaxId`

`payCycle`

`previewCoupon`

`refreshPayment`

`registerPaymentSource`

`resumeSubscription`

`saveBillingProfile`

`startPackCheckout`

`submitPackPurchase`

`submitSubscription`