CryptoPay — Crypto payments, non-custodial

Referencia de la API

URL base https://cryptopay.yanselmask.com/api/v1. También disponible como OpenAPI 3.1 para generar clientes o importarla en Postman.

Facturas

Listar facturas

GET/invoices

Facturas del modo de la clave (live o prueba), las más recientes primero. Filtra por estado, order_id o fecha de creación.

Permiso necesario: invoices:read

Parámetros

Campo	Descripción
`limit` integer Query · Page size (1–100).	Query · Page size (1–100). Por defecto: `20`
`cursor` string Query · Opaque cursor from `meta.next_cursor`.	Query · Opaque cursor from `meta.next_cursor`.
`status` enum (8) Query	Query Uno de: `new, pending, partial, confirming, paid, overpaid, expired, cancelled`
`order_id` string Query	Query
`created_after` string Query	Query
`created_before` string Query	Query

Devuelve una lista de `Invoice`

Campo	Descripción
`id` stringobligatorio
`object` "invoice"obligatorio
`number` integerobligatorio
`status` enum (8)obligatorio	Uno de: `new, pending, partial, confirming, paid, overpaid, expired, cancelled`
`livemode` booleanobligatorio
`description` string \| nullobligatorio
`order_id` string \| nullobligatorio
`metadata` objectobligatorio
`amount` Moneyobligatorio Fiat amount.	Fiat amount.
`crypto` object \| nullobligatorio
`rate` object \| nullobligatorio
`received` objectobligatorio
`flags` objectobligatorio
`customer` objectobligatorio
`urls` objectobligatorio
`payment_link_id` string \| nullobligatorio
`product_id` string \| nullobligatorio
`source` "link" \| "api" \| "manual" \| "billing"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`expires_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`paid_at` string \| nullobligatorio
`updated_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
429RATE_LIMITED
500INTERNAL_ERROR

GET /invoices

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/invoices' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": [
    {
      "id": "7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939",
      "object": "invoice",
      "number": 120,
      "status": "pending",
      "livemode": true,
      "description": "T-shirt",
      "order_id": "SO-1001",
      "metadata": {},
      "amount": {
        "value": "25.00",
        "currency": "USD",
        "minor": 2500
      },
      "crypto": {
        "asset": "usdt_tron",
        "network": "tron",
        "symbol": "USDT",
        "amount": "25.02",
        "amount_base_units": "25020000",
        "decimals": 6,
        "address": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
        "uri": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
        "required_confirmations": 19
      },
      "rate": {
        "fiat_per_asset": "1",
        "locked_at": "2026-10-10T12:00:00.000Z",
        "expires_at": "2026-10-10T13:00:00.000Z"
      },
      "received": {
        "amount": "0",
        "amount_base_units": "0",
        "confirmed_base_units": "0"
      },
      "flags": {
        "paid_late": false,
        "underpaid_accepted": false
      },
      "customer": {
        "email": null,
        "name": null
      },
      "urls": {
        "checkout": "https://pay.example.com/pay/7d61…",
        "receipt": "https://pay.example.com/pay/7d61…/receipt",
        "success": null,
        "cancel": null
      },
      "payment_link_id": null,
      "product_id": null,
      "source": "api",
      "created_at": "2026-10-10T12:00:00.000Z",
      "expires_at": "2026-10-10T13:00:00.000Z",
      "paid_at": null,
      "updated_at": "2026-10-10T12:00:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": null,
    "has_more": false
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Crear una factura

POST/invoices

Crea una factura y devuelve la URL de su checkout alojado (urls.checkout). Envía asset para fijar ya la moneda: la respuesta incluye la dirección y el importe cripto exacto. Envía la cabecera Idempotency-Key para reintentar con seguridad.

Permiso necesario: invoices:write

Cuerpo de la petición

Campo	Descripción
`amount` string \| numberobligatorio Decimal amount as a string (recommended) or number.	Decimal amount as a string (recommended) or number. Ejemplo: `"25.00"`
`currency` enum (10)obligatorio ISO 4217 fiat currency.	ISO 4217 fiat currency. Uno de: `USD, EUR, DOP, MXN, COP, BRL, GBP, ARS, CLP, PEN` Ejemplo: `"USD"`
`description` string
`order_id` string
`customer` object
`success_url` string \| null
`cancel_url` string \| null
`metadata` object Your own key/value pairs (up to 20). Returned in webhooks.	Your own key/value pairs (up to 20). Returned in webhooks.
`asset` enum (22) Lock the currency now: the response already includes `crypto`.	Lock the currency now: the response already includes `crypto`. Uno de: `btc_bitcoin, ltc_litecoin, doge_dogecoin, eth_ethereum, usdt_ethereum, usdc_ethereum, bnb_bsc, usdt_bsc, usdc_bsc, pol_polygon, usdt_polygon, usdc_polygon, eth_base, usdc_base, eth_arbitrum, usdt_arbitrum, usdc_arbitrum, trx_tron, usdt_tron, sol_solana, usdc_solana, usdt_solana` Ejemplo: `"usdt_tron"`
`ttl_minutes` integer

Devuelve `Invoice`

Campo	Descripción
`id` stringobligatorio
`object` "invoice"obligatorio
`number` integerobligatorio
`status` enum (8)obligatorio	Uno de: `new, pending, partial, confirming, paid, overpaid, expired, cancelled`
`livemode` booleanobligatorio
`description` string \| nullobligatorio
`order_id` string \| nullobligatorio
`metadata` objectobligatorio
`amount` Moneyobligatorio Fiat amount.	Fiat amount.
`crypto` object \| nullobligatorio
`rate` object \| nullobligatorio
`received` objectobligatorio
`flags` objectobligatorio
`customer` objectobligatorio
`urls` objectobligatorio
`payment_link_id` string \| nullobligatorio
`product_id` string \| nullobligatorio
`source` "link" \| "api" \| "manual" \| "billing"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`expires_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`paid_at` string \| nullobligatorio
`updated_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

400VALIDATION_ERROR, UNSUPPORTED_ASSET, NO_WALLET_FOR_ASSET, AMOUNT_BELOW_MINIMUM
401UNAUTHENTICATED
403PLAN_LIMIT_REACHED, WORKSPACE_RESTRICTED, FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
409IDEMPOTENCY_MISMATCH, IDEMPOTENCY_IN_PROGRESS
429RATE_LIMITED
500INTERNAL_ERROR
503RATES_UNAVAILABLE

POST /invoices

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/invoices' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Idempotency-Key: 6f1c2a0e-order-1001' \
  -H 'Content-Type: application/json' \
  -d '{
  "amount": "25.00",
  "currency": "USD",
  "description": "T-shirt",
  "order_id": "SO-1001",
  "asset": "usdt_tron"
}'

Respuesta 201

{
  "data": {
    "id": "7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939",
    "object": "invoice",
    "number": 120,
    "status": "pending",
    "livemode": true,
    "description": "T-shirt",
    "order_id": "SO-1001",
    "metadata": {},
    "amount": {
      "value": "25.00",
      "currency": "USD",
      "minor": 2500
    },
    "crypto": {
      "asset": "usdt_tron",
      "network": "tron",
      "symbol": "USDT",
      "amount": "25.02",
      "amount_base_units": "25020000",
      "decimals": 6,
      "address": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
      "uri": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
      "required_confirmations": 19
    },
    "rate": {
      "fiat_per_asset": "1",
      "locked_at": "2026-10-10T12:00:00.000Z",
      "expires_at": "2026-10-10T13:00:00.000Z"
    },
    "received": {
      "amount": "0",
      "amount_base_units": "0",
      "confirmed_base_units": "0"
    },
    "flags": {
      "paid_late": false,
      "underpaid_accepted": false
    },
    "customer": {
      "email": null,
      "name": null
    },
    "urls": {
      "checkout": "https://pay.example.com/pay/7d61…",
      "receipt": "https://pay.example.com/pay/7d61…/receipt",
      "success": null,
      "cancel": null
    },
    "payment_link_id": null,
    "product_id": null,
    "source": "api",
    "created_at": "2026-10-10T12:00:00.000Z",
    "expires_at": "2026-10-10T13:00:00.000Z",
    "paid_at": null,
    "updated_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Obtener una factura

GET/invoices/{id}

Estado actual de una factura, con los importes recibidos y confirmados.

Permiso necesario: invoices:read

Parámetros

Campo	Descripción
`id` stringobligatorio Path	Path

Devuelve `Invoice`

Campo	Descripción
`id` stringobligatorio
`object` "invoice"obligatorio
`number` integerobligatorio
`status` enum (8)obligatorio	Uno de: `new, pending, partial, confirming, paid, overpaid, expired, cancelled`
`livemode` booleanobligatorio
`description` string \| nullobligatorio
`order_id` string \| nullobligatorio
`metadata` objectobligatorio
`amount` Moneyobligatorio Fiat amount.	Fiat amount.
`crypto` object \| nullobligatorio
`rate` object \| nullobligatorio
`received` objectobligatorio
`flags` objectobligatorio
`customer` objectobligatorio
`urls` objectobligatorio
`payment_link_id` string \| nullobligatorio
`product_id` string \| nullobligatorio
`source` "link" \| "api" \| "manual" \| "billing"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`expires_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`paid_at` string \| nullobligatorio
`updated_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
404NOT_FOUND
429RATE_LIMITED
500INTERNAL_ERROR

GET /invoices/{id}

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/invoices/7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": {
    "id": "7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939",
    "object": "invoice",
    "number": 120,
    "status": "pending",
    "livemode": true,
    "description": "T-shirt",
    "order_id": "SO-1001",
    "metadata": {},
    "amount": {
      "value": "25.00",
      "currency": "USD",
      "minor": 2500
    },
    "crypto": {
      "asset": "usdt_tron",
      "network": "tron",
      "symbol": "USDT",
      "amount": "25.02",
      "amount_base_units": "25020000",
      "decimals": 6,
      "address": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
      "uri": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
      "required_confirmations": 19
    },
    "rate": {
      "fiat_per_asset": "1",
      "locked_at": "2026-10-10T12:00:00.000Z",
      "expires_at": "2026-10-10T13:00:00.000Z"
    },
    "received": {
      "amount": "0",
      "amount_base_units": "0",
      "confirmed_base_units": "0"
    },
    "flags": {
      "paid_late": false,
      "underpaid_accepted": false
    },
    "customer": {
      "email": null,
      "name": null
    },
    "urls": {
      "checkout": "https://pay.example.com/pay/7d61…",
      "receipt": "https://pay.example.com/pay/7d61…/receipt",
      "success": null,
      "cancel": null
    },
    "payment_link_id": null,
    "product_id": null,
    "source": "api",
    "created_at": "2026-10-10T12:00:00.000Z",
    "expires_at": "2026-10-10T13:00:00.000Z",
    "paid_at": null,
    "updated_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Cancelar una factura

POST/invoices/{id}/cancel

Cancela una factura new, pending o expired que no haya recibido fondos.

Permiso necesario: invoices:write

Parámetros

Campo	Descripción
`id` stringobligatorio Path	Path

Devuelve `Invoice`

Campo	Descripción
`id` stringobligatorio
`object` "invoice"obligatorio
`number` integerobligatorio
`status` enum (8)obligatorio	Uno de: `new, pending, partial, confirming, paid, overpaid, expired, cancelled`
`livemode` booleanobligatorio
`description` string \| nullobligatorio
`order_id` string \| nullobligatorio
`metadata` objectobligatorio
`amount` Moneyobligatorio Fiat amount.	Fiat amount.
`crypto` object \| nullobligatorio
`rate` object \| nullobligatorio
`received` objectobligatorio
`flags` objectobligatorio
`customer` objectobligatorio
`urls` objectobligatorio
`payment_link_id` string \| nullobligatorio
`product_id` string \| nullobligatorio
`source` "link" \| "api" \| "manual" \| "billing"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`expires_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`paid_at` string \| nullobligatorio
`updated_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
404NOT_FOUND
409INVALID_STATE
429RATE_LIMITED
500INTERNAL_ERROR

POST /invoices/{id}/cancel

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/invoices/7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939/cancel' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": {
    "id": "7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939",
    "object": "invoice",
    "number": 120,
    "status": "pending",
    "livemode": true,
    "description": "T-shirt",
    "order_id": "SO-1001",
    "metadata": {},
    "amount": {
      "value": "25.00",
      "currency": "USD",
      "minor": 2500
    },
    "crypto": {
      "asset": "usdt_tron",
      "network": "tron",
      "symbol": "USDT",
      "amount": "25.02",
      "amount_base_units": "25020000",
      "decimals": 6,
      "address": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
      "uri": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
      "required_confirmations": 19
    },
    "rate": {
      "fiat_per_asset": "1",
      "locked_at": "2026-10-10T12:00:00.000Z",
      "expires_at": "2026-10-10T13:00:00.000Z"
    },
    "received": {
      "amount": "0",
      "amount_base_units": "0",
      "confirmed_base_units": "0"
    },
    "flags": {
      "paid_late": false,
      "underpaid_accepted": false
    },
    "customer": {
      "email": null,
      "name": null
    },
    "urls": {
      "checkout": "https://pay.example.com/pay/7d61…",
      "receipt": "https://pay.example.com/pay/7d61…/receipt",
      "success": null,
      "cancel": null
    },
    "payment_link_id": null,
    "product_id": null,
    "source": "api",
    "created_at": "2026-10-10T12:00:00.000Z",
    "expires_at": "2026-10-10T13:00:00.000Z",
    "paid_at": null,
    "updated_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Links de pago

Listar links de pago

GET/payment-links

Links de pago del workspace, los más recientes primero.

Permiso necesario: links:read

Parámetros

Campo Descripción

limit

integer

Query · Page size (1–100).

Por defecto: 20

cursor

string

Query · Opaque cursor from meta.next_cursor.

Devuelve una lista de `PaymentLink`

Campo	Descripción
`id` stringobligatorio
`object` "payment_link"obligatorio
`url` stringobligatorio
`slug` stringobligatorio
`kind` "product" \| "custom"obligatorio
`product_id` string \| nullobligatorio
`title` stringobligatorio
`description` string \| nullobligatorio
`amount` Money \| nullobligatorio
`allow_custom_amount` booleanobligatorio
`min_amount` Money \| nullobligatorio
`max_amount` Money \| nullobligatorio
`reusable` booleanobligatorio
`max_uses` integer \| nullobligatorio
`uses_count` integerobligatorio
`expires_at` string \| nullobligatorio
`success_url` string \| nullobligatorio
`cancel_url` string \| nullobligatorio
`collect_email` booleanobligatorio
`collect_name` booleanobligatorio
`metadata` objectobligatorio
`is_active` booleanobligatorio
`status` "active" \| "inactive" \| "expired" \| "exhausted"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
429RATE_LIMITED
500INTERNAL_ERROR

GET /payment-links

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/payment-links' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": [
    {
      "created_at": "2026-10-10T12:00:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": null,
    "has_more": false
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Crear un link de pago

POST/payment-links

Con product_id el link copia el título, el precio y la moneda del producto. Sin él, envía title, currency y amount o allow_custom_amount (con min_amount/max_amount opcionales).

Permiso necesario: links:write

Cuerpo de la petición

Campo	Descripción
`product_id` string Create the link from a product (copies title, price and currency).	Create the link from a product (copies title, price and currency).
`title` string
`description` string
`amount` string \| number Decimal amount as a string (recommended) or number.	Decimal amount as a string (recommended) or number. Ejemplo: `"25.00"`
`currency` enum (10) ISO 4217 fiat currency.	ISO 4217 fiat currency. Uno de: `USD, EUR, DOP, MXN, COP, BRL, GBP, ARS, CLP, PEN` Ejemplo: `"USD"`
`allow_custom_amount` boolean
`min_amount` string \| number Decimal amount as a string (recommended) or number.	Decimal amount as a string (recommended) or number. Ejemplo: `"25.00"`
`max_amount` string \| number Decimal amount as a string (recommended) or number.	Decimal amount as a string (recommended) or number. Ejemplo: `"25.00"`
`reusable` boolean
`max_uses` integer
`expires_at` string
`success_url` string \| null
`cancel_url` string \| null
`collect_email` boolean
`collect_name` boolean
`metadata` object Your own key/value pairs (up to 20). Returned in webhooks.	Your own key/value pairs (up to 20). Returned in webhooks.

Devuelve `PaymentLink`

Campo	Descripción
`id` stringobligatorio
`object` "payment_link"obligatorio
`url` stringobligatorio
`slug` stringobligatorio
`kind` "product" \| "custom"obligatorio
`product_id` string \| nullobligatorio
`title` stringobligatorio
`description` string \| nullobligatorio
`amount` Money \| nullobligatorio
`allow_custom_amount` booleanobligatorio
`min_amount` Money \| nullobligatorio
`max_amount` Money \| nullobligatorio
`reusable` booleanobligatorio
`max_uses` integer \| nullobligatorio
`uses_count` integerobligatorio
`expires_at` string \| nullobligatorio
`success_url` string \| nullobligatorio
`cancel_url` string \| nullobligatorio
`collect_email` booleanobligatorio
`collect_name` booleanobligatorio
`metadata` objectobligatorio
`is_active` booleanobligatorio
`status` "active" \| "inactive" \| "expired" \| "exhausted"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403PLAN_LIMIT_REACHED, WORKSPACE_RESTRICTED, FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
404NOT_FOUND
409INVALID_STATE, IDEMPOTENCY_MISMATCH, IDEMPOTENCY_IN_PROGRESS
429RATE_LIMITED
500INTERNAL_ERROR

POST /payment-links

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/payment-links' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Idempotency-Key: 6f1c2a0e-order-1001' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "Donation",
  "currency": "USD",
  "allow_custom_amount": true,
  "min_amount": "5.00",
  "max_amount": "500.00"
}'

Respuesta 201

{
  "data": {
    "created_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Obtener un link de pago

GET/payment-links/{id}

Un link de pago con su estado y su número de usos.

Permiso necesario: links:read

Parámetros

Campo	Descripción
`id` stringobligatorio Path	Path

Devuelve `PaymentLink`

Campo	Descripción
`id` stringobligatorio
`object` "payment_link"obligatorio
`url` stringobligatorio
`slug` stringobligatorio
`kind` "product" \| "custom"obligatorio
`product_id` string \| nullobligatorio
`title` stringobligatorio
`description` string \| nullobligatorio
`amount` Money \| nullobligatorio
`allow_custom_amount` booleanobligatorio
`min_amount` Money \| nullobligatorio
`max_amount` Money \| nullobligatorio
`reusable` booleanobligatorio
`max_uses` integer \| nullobligatorio
`uses_count` integerobligatorio
`expires_at` string \| nullobligatorio
`success_url` string \| nullobligatorio
`cancel_url` string \| nullobligatorio
`collect_email` booleanobligatorio
`collect_name` booleanobligatorio
`metadata` objectobligatorio
`is_active` booleanobligatorio
`status` "active" \| "inactive" \| "expired" \| "exhausted"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
404NOT_FOUND
429RATE_LIMITED
500INTERNAL_ERROR

GET /payment-links/{id}

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/payment-links/7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": {
    "created_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Desactivar un link de pago

POST/payment-links/{id}/deactivate

El link deja de aceptar pagos nuevos; las facturas existentes no se ven afectadas.

Permiso necesario: links:write

Parámetros

Campo	Descripción
`id` stringobligatorio Path	Path

Devuelve `PaymentLink`

Campo	Descripción
`id` stringobligatorio
`object` "payment_link"obligatorio
`url` stringobligatorio
`slug` stringobligatorio
`kind` "product" \| "custom"obligatorio
`product_id` string \| nullobligatorio
`title` stringobligatorio
`description` string \| nullobligatorio
`amount` Money \| nullobligatorio
`allow_custom_amount` booleanobligatorio
`min_amount` Money \| nullobligatorio
`max_amount` Money \| nullobligatorio
`reusable` booleanobligatorio
`max_uses` integer \| nullobligatorio
`uses_count` integerobligatorio
`expires_at` string \| nullobligatorio
`success_url` string \| nullobligatorio
`cancel_url` string \| nullobligatorio
`collect_email` booleanobligatorio
`collect_name` booleanobligatorio
`metadata` objectobligatorio
`is_active` booleanobligatorio
`status` "active" \| "inactive" \| "expired" \| "exhausted"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
404NOT_FOUND
429RATE_LIMITED
500INTERNAL_ERROR

POST /payment-links/{id}/deactivate

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/payment-links/7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939/deactivate' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": {
    "created_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Productos

Listar productos

GET/products

Productos del catálogo, los más recientes primero.

Permiso necesario: products:read

Parámetros

Campo Descripción

limit

integer

Query · Page size (1–100).

Por defecto: 20

cursor

string

Query · Opaque cursor from meta.next_cursor.

Devuelve una lista de `Product`

Campo	Descripción
`id` stringobligatorio
`object` "product"obligatorio
`name` stringobligatorio
`description` string \| nullobligatorio
`image_url` string \| nullobligatorio
`price` Moneyobligatorio Fiat amount.	Fiat amount.
`sku` string \| nullobligatorio
`is_active` booleanobligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`updated_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
429RATE_LIMITED
500INTERNAL_ERROR

GET /products

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/products' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": [
    {
      "price": {
        "value": "25.00",
        "currency": "USD",
        "minor": 2500
      },
      "created_at": "2026-10-10T12:00:00.000Z",
      "updated_at": "2026-10-10T12:00:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": null,
    "has_more": false
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Crear un producto

POST/products

Añade un producto al catálogo. sku debe ser único en el workspace.

Permiso necesario: products:write

Cuerpo de la petición

Campo	Descripción
`name` stringobligatorio
`description` string
`price` string \| numberobligatorio Decimal amount as a string (recommended) or number.	Decimal amount as a string (recommended) or number. Ejemplo: `"25.00"`
`currency` enum (10)obligatorio ISO 4217 fiat currency.	ISO 4217 fiat currency. Uno de: `USD, EUR, DOP, MXN, COP, BRL, GBP, ARS, CLP, PEN` Ejemplo: `"USD"`
`sku` string

Devuelve `Product`

Campo	Descripción
`id` stringobligatorio
`object` "product"obligatorio
`name` stringobligatorio
`description` string \| nullobligatorio
`image_url` string \| nullobligatorio
`price` Moneyobligatorio Fiat amount.	Fiat amount.
`sku` string \| nullobligatorio
`is_active` booleanobligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`updated_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403WORKSPACE_RESTRICTED, FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
409IDEMPOTENCY_MISMATCH, IDEMPOTENCY_IN_PROGRESS
429RATE_LIMITED
500INTERNAL_ERROR

POST /products

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/products' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Idempotency-Key: 6f1c2a0e-order-1001' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "T-shirt",
  "price": "25.00",
  "currency": "USD",
  "sku": "TSHIRT-01"
}'

Respuesta 201

{
  "data": {
    "price": {
      "value": "25.00",
      "currency": "USD",
      "minor": 2500
    },
    "created_at": "2026-10-10T12:00:00.000Z",
    "updated_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Obtener un producto

GET/products/{id}

Un producto del catálogo.

Permiso necesario: products:read

Parámetros

Campo	Descripción
`id` stringobligatorio Path	Path

Devuelve `Product`

Campo	Descripción
`id` stringobligatorio
`object` "product"obligatorio
`name` stringobligatorio
`description` string \| nullobligatorio
`image_url` string \| nullobligatorio
`price` Moneyobligatorio Fiat amount.	Fiat amount.
`sku` string \| nullobligatorio
`is_active` booleanobligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`updated_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
404NOT_FOUND
429RATE_LIMITED
500INTERNAL_ERROR

GET /products/{id}

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/products/7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": {
    "price": {
      "value": "25.00",
      "currency": "USD",
      "minor": 2500
    },
    "created_at": "2026-10-10T12:00:00.000Z",
    "updated_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Pagos

Listar pagos

GET/payments

Transferencias en cadena atribuidas a facturas del modo de la clave, las más recientes primero. Filtra por invoice_id.

Permiso necesario: payments:read

Parámetros

Campo Descripción

limit

integer

Query · Page size (1–100).

Por defecto: 20

cursor

string

Query · Opaque cursor from meta.next_cursor.

invoice_id

string

Query

Devuelve una lista de `Payment`

Campo	Descripción
`id` stringobligatorio
`object` "payment"obligatorio
`invoice_id` stringobligatorio
`livemode` booleanobligatorio
`network` stringobligatorio
`asset` stringobligatorio
`txid` stringobligatorio
`output_index` integerobligatorio
`from_address` string \| nullobligatorio
`to_address` stringobligatorio
`amount` stringobligatorio
`amount_base_units` stringobligatorio
`confirmations` integerobligatorio
`status` "detected" \| "confirmed" \| "failed"obligatorio
`block_height` integer \| nullobligatorio
`block_time` string \| nullobligatorio
`explorer_url` string \| nullobligatorio
`first_seen_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`confirmed_at` string \| nullobligatorio

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
429RATE_LIMITED
500INTERNAL_ERROR

GET /payments

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/payments' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": [
    {
      "first_seen_at": "2026-10-10T12:00:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": null,
    "has_more": false
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Monedas y tasas

Listar monedas

GET/currencies

Activos cripto que admite la plataforma, con importe mínimo, confirmaciones y si este workspace puede recibirlos ahora.

Permiso necesario: rates:read

Devuelve una lista de `Currency`

Campo	Descripción
`asset` stringobligatorio
`network` stringobligatorio
`symbol` stringobligatorio
`name` stringobligatorio
`decimals` integerobligatorio
`kind` "native" \| "token"obligatorio
`contract` string \| nullobligatorio
`min_amount` stringobligatorio
`min_amount_base_units` stringobligatorio
`required_confirmations` integerobligatorio
`enabled_for_workspace` booleanobligatorio

Errores

401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
429RATE_LIMITED
500INTERNAL_ERROR

GET /currencies

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/currencies' \
  -H 'Authorization: Bearer cp_test_••••'

Obtener tasas de cambio

GET/rates

Precio actual de cada activo en una moneda fiat (fiat, USD por defecto). Envía asset para un solo activo.

Permiso necesario: rates:read

Parámetros

Campo Descripción

Campo	Descripción
`fiat` enum (10) Query · ISO 4217 fiat currency.	Query · ISO 4217 fiat currency. Por defecto: `"USD"` Uno de: `USD, EUR, DOP, MXN, COP, BRL, GBP, ARS, CLP, PEN` Ejemplo: `"USD"`
`asset` enum (22) Query · Asset id: `<symbol>_<network>`.	Query · Asset id: `<symbol>_<network>`. Uno de: `btc_bitcoin, ltc_litecoin, doge_dogecoin, eth_ethereum, usdt_ethereum, usdc_ethereum, bnb_bsc, usdt_bsc, usdc_bsc, pol_polygon, usdt_polygon, usdc_polygon, eth_base, usdc_base, eth_arbitrum, usdt_arbitrum, usdc_arbitrum, trx_tron, usdt_tron, sol_solana, usdc_solana, usdt_solana` Ejemplo: `"usdt_tron"`

fiat

enum (10)

Query · ISO 4217 fiat currency.

Por defecto: "USD"

Uno de: USD, EUR, DOP, MXN, COP, BRL, GBP, ARS, CLP, PEN

Ejemplo: "USD"

asset

enum (22)

Query · Asset id: <symbol>_<network>.

Uno de: btc_bitcoin, ltc_litecoin, doge_dogecoin, eth_ethereum, usdt_ethereum, usdc_ethereum, bnb_bsc, usdt_bsc, usdc_bsc, pol_polygon, usdt_polygon, usdc_polygon, eth_base, usdc_base, eth_arbitrum, usdt_arbitrum, usdc_arbitrum, trx_tron, usdt_tron, sol_solana, usdc_solana, usdt_solana

Ejemplo: "usdt_tron"

Devuelve una lista de `Rate`

Campo	Descripción
`fiat` stringobligatorio
`asset` stringobligatorio
`fiat_per_asset` stringobligatorio
`asset_usd` stringobligatorio
`fetched_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`stale` booleanobligatorio

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
429RATE_LIMITED
500INTERNAL_ERROR
503RATES_UNAVAILABLE

GET /rates

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/rates' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": [
    {
      "fetched_at": "2026-10-10T12:00:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": null,
    "has_more": false
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Estimar un importe cripto

POST/estimate

Convierte un precio fiat a un activo con la tasa actual. La tasa no queda fijada: crea una factura para fijarla.

Permiso necesario: rates:read

Cuerpo de la petición

Campo Descripción

amount

string | numberobligatorio

Decimal amount as a string (recommended) or number.

Ejemplo: "25.00"

currency

enum (10)obligatorio

ISO 4217 fiat currency.

Uno de: USD, EUR, DOP, MXN, COP, BRL, GBP, ARS, CLP, PEN

Ejemplo: "USD"

asset

enum (22)obligatorio

Asset id: <symbol>_<network>.

Ejemplo: "usdt_tron"

Devuelve `Estimate`

Campo	Descripción
`amount` Moneyobligatorio Fiat amount.	Fiat amount.
`asset` stringobligatorio
`crypto_amount` stringobligatorio
`amount_base_units` stringobligatorio
`rate` Rateobligatorio Price of 1 unit of the asset in the fiat currency.	Price of 1 unit of the asset in the fiat currency.

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
429RATE_LIMITED
500INTERNAL_ERROR
503RATES_UNAVAILABLE

POST /estimate

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/estimate' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Content-Type: application/json' \
  -d '{
  "amount": "100.00",
  "currency": "EUR",
  "asset": "btc_bitcoin"
}'

Respuesta 200

{
  "data": {
    "amount": {
      "value": "25.00",
      "currency": "USD",
      "minor": 2500
    },
    "rate": {
      "fetched_at": "2026-10-10T12:00:00.000Z"
    }
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Endpoints de webhook

Listar endpoints de webhook

GET/webhook-endpoints

Endpoints que reciben eventos. Aquí nunca se devuelven los secretos.

Permiso necesario: webhooks:manage

Devuelve una lista de `WebhookEndpoint`

Campo	Descripción
`id` stringobligatorio
`object` "webhook_endpoint"obligatorio
`url` stringobligatorio
`description` string \| nullobligatorio
`events` string[]obligatorio
`mode` "live" \| "test" \| "both"obligatorio
`is_active` booleanobligatorio
`secret` string Only returned once, when the endpoint is created.	Only returned once, when the endpoint is created.
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
429RATE_LIMITED
500INTERNAL_ERROR

GET /webhook-endpoints

curl -X GET 'https://cryptopay.yanselmask.com/api/v1/webhook-endpoints' \
  -H 'Authorization: Bearer cp_test_••••'

Respuesta 200

{
  "data": [
    {
      "created_at": "2026-10-10T12:00:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": null,
    "has_more": false
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Crear un endpoint de webhook

POST/webhook-endpoints

La URL debe ser https:// pública (http://localhost solo para endpoints de prueba). El secret de firma solo se devuelve en esta respuesta.

Permiso necesario: webhooks:manage

Cuerpo de la petición

Campo	Descripción
`url` stringobligatorio
`description` string
`events` enum (13)[]	Por defecto: `["*"]`
`mode` "live" \| "test" \| "both"

Devuelve `WebhookEndpoint`

Campo	Descripción
`id` stringobligatorio
`object` "webhook_endpoint"obligatorio
`url` stringobligatorio
`description` string \| nullobligatorio
`events` string[]obligatorio
`mode` "live" \| "test" \| "both"obligatorio
`is_active` booleanobligatorio
`secret` string Only returned once, when the endpoint is created.	Only returned once, when the endpoint is created.
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

400VALIDATION_ERROR
401UNAUTHENTICATED
403PLAN_LIMIT_REACHED, FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
409INVALID_STATE, IDEMPOTENCY_MISMATCH, IDEMPOTENCY_IN_PROGRESS
429RATE_LIMITED
500INTERNAL_ERROR

POST /webhook-endpoints

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/webhook-endpoints' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Idempotency-Key: 6f1c2a0e-order-1001' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://shop.example.com/webhooks/crypto",
  "events": [
    "*"
  ]
}'

Respuesta 201

{
  "data": {
    "created_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Eliminar un endpoint de webhook

DELETE/webhook-endpoints/{id}

Elimina el endpoint y sus entregas pendientes.

Permiso necesario: webhooks:manage

Parámetros

Campo	Descripción
`id` stringobligatorio Path	Path

Devuelve `Deleted`

Campo	Descripción
`id` stringobligatorio
`deleted` trueobligatorio

Errores

401UNAUTHENTICATED
403FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
404NOT_FOUND
429RATE_LIMITED
500INTERNAL_ERROR

DELETE /webhook-endpoints/{id}

curl -X DELETE 'https://cryptopay.yanselmask.com/api/v1/webhook-endpoints/7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939' \
  -H 'Authorization: Bearer cp_test_••••'

Pruebas

Simular un pago

POST/test/invoices/{id}/simulate

Solo claves de prueba. Lleva una factura de prueba a paid, partial, overpaid o expired por la misma máquina de estados que los pagos reales, emitiendo eventos y webhooks con livemode: false. Una factura en new toma primero el primer activo que el workspace puede recibir.

Permiso necesario: invoices:write · solo claves de prueba

Parámetros

Campo	Descripción
`id` stringobligatorio Path	Path

Cuerpo de la petición

Campo	Descripción
`scenario` "paid" \| "partial" \| "overpaid" \| "expired"obligatorio

Devuelve `Invoice`

Campo	Descripción
`id` stringobligatorio
`object` "invoice"obligatorio
`number` integerobligatorio
`status` enum (8)obligatorio	Uno de: `new, pending, partial, confirming, paid, overpaid, expired, cancelled`
`livemode` booleanobligatorio
`description` string \| nullobligatorio
`order_id` string \| nullobligatorio
`metadata` objectobligatorio
`amount` Moneyobligatorio Fiat amount.	Fiat amount.
`crypto` object \| nullobligatorio
`rate` object \| nullobligatorio
`received` objectobligatorio
`flags` objectobligatorio
`customer` objectobligatorio
`urls` objectobligatorio
`payment_link_id` string \| nullobligatorio
`product_id` string \| nullobligatorio
`source` "link" \| "api" \| "manual" \| "billing"obligatorio
`created_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`expires_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`
`paid_at` string \| nullobligatorio
`updated_at` stringobligatorio ISO 8601 UTC timestamp.	ISO 8601 UTC timestamp. Ejemplo: `"2026-10-10T12:00:00.000Z"`

Errores

400VALIDATION_ERROR, NO_WALLET_FOR_ASSET
401UNAUTHENTICATED
403TEST_MODE_ONLY, FORBIDDEN_SCOPE, WORKSPACE_SUSPENDED
404NOT_FOUND
409INVALID_STATE
429RATE_LIMITED
500INTERNAL_ERROR

POST /test/invoices/{id}/simulate

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/test/invoices/7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939/simulate' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Content-Type: application/json' \
  -d '{
  "scenario": "paid"
}'

Respuesta 200

{
  "data": {
    "id": "7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939",
    "object": "invoice",
    "number": 120,
    "status": "pending",
    "livemode": true,
    "description": "T-shirt",
    "order_id": "SO-1001",
    "metadata": {},
    "amount": {
      "value": "25.00",
      "currency": "USD",
      "minor": 2500
    },
    "crypto": {
      "asset": "usdt_tron",
      "network": "tron",
      "symbol": "USDT",
      "amount": "25.02",
      "amount_base_units": "25020000",
      "decimals": 6,
      "address": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
      "uri": "TJYeasTPa6gpEEfYqeoTBpFkqZ4jhy5zj7",
      "required_confirmations": 19
    },
    "rate": {
      "fiat_per_asset": "1",
      "locked_at": "2026-10-10T12:00:00.000Z",
      "expires_at": "2026-10-10T13:00:00.000Z"
    },
    "received": {
      "amount": "0",
      "amount_base_units": "0",
      "confirmed_base_units": "0"
    },
    "flags": {
      "paid_late": false,
      "underpaid_accepted": false
    },
    "customer": {
      "email": null,
      "name": null
    },
    "urls": {
      "checkout": "https://pay.example.com/pay/7d61…",
      "receipt": "https://pay.example.com/pay/7d61…/receipt",
      "success": null,
      "cancel": null
    },
    "payment_link_id": null,
    "product_id": null,
    "source": "api",
    "created_at": "2026-10-10T12:00:00.000Z",
    "expires_at": "2026-10-10T13:00:00.000Z",
    "paid_at": null,
    "updated_at": "2026-10-10T12:00:00.000Z"
  },
  "error": null,
  "request_id": "req_01J9ZQ3K5W8X2N4M6P7R9S1T3V"
}

Facturas

Listar facturas

Parámetros

Devuelve una lista de Invoice

Errores

Crear una factura

Cuerpo de la petición

Devuelve Invoice

Errores

Obtener una factura

Parámetros

Devuelve Invoice

Errores

Cancelar una factura

Parámetros

Devuelve Invoice

Errores

Links de pago

Listar links de pago

Parámetros

Devuelve una lista de PaymentLink

Errores

Crear un link de pago

Cuerpo de la petición

Devuelve PaymentLink

Errores

Obtener un link de pago

Parámetros

Devuelve PaymentLink

Errores

Desactivar un link de pago

Parámetros

Devuelve PaymentLink

Errores

Productos

Listar productos

Parámetros

Devuelve una lista de Product

Errores

Crear un producto

Cuerpo de la petición

Devuelve Product

Errores

Obtener un producto

Parámetros

Devuelve Product

Errores

Pagos

Listar pagos

Parámetros

Devuelve una lista de Payment

Errores

Monedas y tasas

Listar monedas

Devuelve una lista de Currency

Errores

Obtener tasas de cambio

Parámetros

Devuelve una lista de Rate

Errores

Estimar un importe cripto

Cuerpo de la petición

Devuelve Estimate

Errores

Endpoints de webhook

Listar endpoints de webhook

Devuelve una lista de WebhookEndpoint

Errores

Crear un endpoint de webhook

Cuerpo de la petición

Devuelve WebhookEndpoint

Errores

Eliminar un endpoint de webhook

Parámetros

Devuelve Deleted

Errores

Pruebas

Simular un pago

Parámetros

Cuerpo de la petición

Devuelve una lista de `Invoice`

Devuelve `Invoice`

Devuelve `Invoice`

Devuelve `Invoice`

Devuelve una lista de `PaymentLink`

Devuelve `PaymentLink`

Devuelve `PaymentLink`

Devuelve `PaymentLink`

Devuelve una lista de `Product`

Devuelve `Product`

Devuelve `Product`

Devuelve una lista de `Payment`

Devuelve una lista de `Currency`

Devuelve una lista de `Rate`

Devuelve `Estimate`

Devuelve una lista de `WebhookEndpoint`

Devuelve `WebhookEndpoint`

Devuelve `Deleted`

Devuelve `Invoice`