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

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"]

dueTimeinteger

Link expiration time in seconds (60 seconds to 120 days)

Possible values: >= 60 and <= 10368000

Default value: 172800

Example: 172800

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",
  "formData": {
    "customer_name": {
      "value": "John Doe",
      "label": "Customer Name"
    }
  },
  "supportedPayments": [
    "crypto",
    "bank_transfer"
  ],
  "dueTime": 172800,
  "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"
  }
}