CreateTempLinkRequest

namestringrequired

Human-readable name for the temporary link

Possible values: non-empty and <= 255 characters

Example: Invoice #1234

paymentLinkintegerrequired

Payment link template ID from your Basilic dashboard

Possible values: >= 1

Example: 17

amountdecimalrequired

Payment amount

Possible values: >= 0.01

Example: 150

currencystringrequired

ISO 4217 currency code

Possible values: Value must match regular expression ^[A-Z]{3}$

Example: USD

clientTaxIdstring

Optional client tax identifier (CUIT / tax ID) used to bind the temp-link to a Basilic client.

Example: 30712345678

clientNamestring

Optional client name used when creating a lightweight client for a previously unseen clientTaxId.

Example: Acme SA

formData object

Pre-filled form data matching the payment link template fields

property name* FormValueObject

valuestringrequired

The actual value to be stored

labelstringrequired

Human-readable label for display

supportedPaymentsstring[]required

Allowed payment methods for this link

Possible values: [crypto, bank_transfer, credit_card, argentine_bank], >= 1

Example: ["crypto","bank_transfer"]

dueTimeUnitstring

Unit for dueTime. Use "days" for simplicity (1–120) or "seconds" for precision.

Possible values: [seconds, days]

Default value: seconds

Example: days

dueTimeinteger

Link expiration duration. When dueTimeUnit is "days": 1–120. When "seconds": 60–10,368,000. If omitted, the effective default is 172800 because dueTimeUnit defaults to "seconds".

Possible values: >= 1 and <= 10368000

Default value: 172800

Example: 7

redirectUrluri

Single redirect URL used for both success and failure. Cannot be combined with successUrl or failureUrl.

Example: https://merchant.example/checkout/result

successUrluri

Redirect URL used after a successful payment completion.

Example: https://merchant.example/checkout/success

failureUrluri

Redirect URL used after a failed payment completion.

Example: https://merchant.example/checkout/failure

merchant_idstring

Your internal reference ID

Possible values: <= 255 characters

Example: ORDER_12345

metadata object

Custom metadata for your own tracking

property name*any

Custom metadata for your own tracking

Example: {"order_id":"12345","customer_tier":"premium"}

CreateTempLinkRequest

{
  "name": "Invoice #1234",
  "paymentLink": 17,
  "amount": 150,
  "currency": "USD",
  "clientTaxId": "30712345678",
  "clientName": "Acme SA",
  "formData": {
    "customer_name": {
      "value": "John Doe",
      "label": "Customer Name"
    }
  },
  "supportedPayments": [
    "crypto",
    "bank_transfer"
  ],
  "dueTimeUnit": "days",
  "dueTime": 7,
  "redirectUrl": "https://merchant.example/checkout/result",
  "successUrl": "https://merchant.example/checkout/success",
  "failureUrl": "https://merchant.example/checkout/failure",
  "merchant_id": "ORDER_12345",
  "metadata": {
    "order_id": "12345",
    "customer_tier": "premium"
  }
}