Skip to main content
Version: 1.0.0

Basilic Temporary Payment Links API

The Basilic Temporary Payment Links API enables merchants to programmatically create and manage temporary, one-time payment links for their customers.

Integration Flow​

Features​

  • Temporary Links: Create time-limited payment links with customizable expiration
  • Redirects: Configure a single completion redirect or separate success/failure redirects
  • Payment Link Templates: List reusable templates before creating temp-links
  • Multiple Payment Methods: Support for crypto, bank transfers, Argentine bank transfers (CVU/CBU), and credit cards
  • Form Data Pre-filling: Pre-populate payment forms with customer information
  • Real-time Status: Track payment status and retrieve payment history
  • Idempotency: Prevent duplicate operations with idempotency keys

Authentication​

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer wp_live_your_api_key_here

You can generate API keys from your Basilic dashboard at Settings > 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