Saltar al contenido principal
Version: 1.0.0

API de Links de Pago Temporales de Basilic

La API de Links de Pago Temporales de Basilic permite a los merchants crear y gestionar links de pago temporales de forma programática.

Flujo de Integración​

Funcionalidades​

  • Links Temporales: Creá links de pago con tiempo limitado y expiración configurable
  • Redirecciones: Configurá una redirección única al finalizar o redirecciones separadas para éxito/error
  • Plantillas de Links de Pago: Listá plantillas reutilizables antes de crear temp-links
  • Múltiples Métodos de Pago: Soporte para cripto, transferencias bancarias, transferencias argentinas (CVU/CBU) y tarjetas de crédito
  • Pre-carga de Datos: Pre-completá formularios de pago con información del cliente
  • Estado en Tiempo Real: Seguí el estado del pago y consultá el historial de pagos
  • Idempotencia: Evitá operaciones duplicadas con claves de idempotencia

Autenticación​

Todas las solicitudes a la API requieren autenticación mediante una API key. Incluila en el header Authorization:

Authorization: Bearer wp_live_your_api_key_here

Podés generar API keys desde tu dashboard de Basilic en Configuración > API Keys.

Rate limit information is included in response headers:

  • X-RateLimit-Limit: Maximum requests per minute
  • X-RateLimit-Remaining: Remaining requests in current window
  • X-RateLimit-Reset: Timestamp when the rate limit resets

Idempotency​

To prevent duplicate operations, include an Idempotency-Key header with POST requests:

Idempotency-Key: unique-request-id-123
  • Idempotency keys are valid for 24 hours
  • Repeated requests with the same key return the original response
  • Different request bodies with the same key result in a 409 Conflict error

Error Handling​

The API uses standard HTTP status codes and returns errors in a consistent format:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": ["Optional additional details"]
  },
  "timestamp": "2025-01-01T00:00:00.000Z",
  "path": "/api/v1/temp-links"
}

Common Error Codes​

  • UNAUTHORIZED: Invalid or missing API key
  • RATE_LIMIT_EXCEEDED: Too many requests
  • VALIDATION_ERROR: Invalid request data
  • RESOURCE_NOT_FOUND: Requested resource doesn't exist
  • PAYMENT_LINK_NOT_FOUND: Payment link template doesn't exist
  • FORM_VALIDATION_ERROR: Form data doesn't match template
  • IDEMPOTENCY_CONFLICT: Same key used with different request
  • INTERNAL_SERVER_ERROR: Unexpected server error

Webhooks (Coming Soon)​

Webhook support will be added in a future update to notify your systems of payment events in real-time.

Authentication​

API key authentication. Format: wp_{environment}_{random_string}

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

API Key