Skip to main content
POST
Create a payment link

Authorizations

Authorization
string
header
required

An access token (at_test_… or at_live_…) from POST https://idp.talescria.com/oauth/token.

Headers

Idempotency-Key
string
required

A unique key for this operation. Send the same key when you retry it. Kept for 24 hours.

Required string length: 8 - 255
Pattern: ^[A-Za-z0-9_\-:.]+$

Body

application/json
accountId
string
required

An account id from GET /v1/accounts.

minorUnits
string
required
Pattern: ^[1-9]\d{0,14}$
currency
enum<string>
required
Available options:
USD,
GBP,
EUR
usage
enum<string>
required
Available options:
single,
reusable
description
string

Shown to the payer. Plain text.

Maximum string length: 500
expiresAt
integer

Epoch ms; at most a year out.

customerId
string

Who it's for: one of your customers (GET /v1/customers). Never shown to the payer.

Response

Made.