create_2

POST

/v1/payment-links

curl --request POST \
  --url https://api.lydiagate.com/v1/payment-links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "amount": 1, "terminalId": "example", "customerCommissionShareBps": 1, "description": "example", "redirectUrl": "example", "allowedInstallmentCounts": [ 1 ], "items": [ { "name": "example", "note": "example", "amount": 1 } ], "payerName": "example" }'

Authorizations

• BearerAuth

Request Body^required

Media typeapplication/json

object

amount

required

integer format: int64

>= 1

terminalId

required

string

>= 1 characters

customerCommissionShareBps

integer | null format: int32

<= 10000

description

string | null

redirectUrl

string | null

0 <= 512 characters

allowedInstallmentCounts

Array<integer> | null

items

Array<object> | null

>= 1 items <= 50 items

object

name

required

string

0 <= 120 characters

note

string | null

0 <= 200 characters

amount

required

integer format: int64

>= 1

payerName

string | null

0 <= 120 characters

Example^generated

{
  "amount": 1,
  "terminalId": "example",
  "customerCommissionShareBps": 1,
  "description": "example",
  "redirectUrl": "example",
  "allowedInstallmentCounts": [
    1
  ],
  "items": [
    {
      "name": "example",
      "note": "example",
      "amount": 1
    }
  ],
  "payerName": "example"
}

Responses

201

Ödeme linki oluşturuldu.

Media typeapplication/json

object

id

string

token

string

url

string

partnerReference

integer format: int64

status

string

Allowed values: pending launched initiated completed expired failed cancelled

amount

integer format: int64

customerCommissionShareBps

integer format: int32

description

string | null

redirectUrl

string | null

firstOpenedAt

string | null format: date-time

lastOpenedAt

string | null format: date-time

expiresAt

string format: date-time

createdAt

string format: date-time

updatedAt

string format: date-time

allowedInstallmentCounts

Array<integer> | null

items

Array<object> | null

object

name

string

note

string | null

amount

integer format: int64

payerName

string | null

Example

{
  "status": "pending"
}

429

API anahtarı mutation kotası veya kaynak-IP hız limiti aşıldı; link oluşturulmadı.

Media typeapplication/json

object

error

object

code

string

Allowed values: rate_limited

message

string

traceId

string | null

Example

{
  "error": {
    "code": "rate_limited"
  }
}

Headers

Retry-After

integer format: int64

Yeniden denemeden önce beklenecek saniye.