BAbanqzinc
Payment Links

Create a new payment link (Partner or Merchant authentication)

Changed on

Create a new payment link (Partner or Merchant authentication)

post/api/v1/payment-links

Request

Request body

merchant_idstring uuid

Required for Partner authentication, forbidden for Merchant authentication

metadataobject

Optional metadata to attach to the payment link

Example request

{
  "order": {
    "amount": 1000,
    "currency": "GBP",
    "payment_reference": "Invoice #123",
    "order_id": "ORD-123456",
    "locale": "en",
    "test_transaction": true
  },
  "redirect_urls": {
    "success_url": "https://example.com/payment/success",
    "failure_url": "https://example.com/payment/failure"
  }
}

Response

Created

successboolean required

Indicates if the request was successful

Example response

{
  "success": true,
  "data": {
    "payment_link_url": "https://core.quidkey.com/payment-link/a1b2c3d4e5f6..."
  }
}

Changes

  • b372e7d5563dRevision changes
    • breaking

      the / request property's minLength was increased from 0 to 3

    • breaking

      added the pattern ^[A-Za-z]{3}$ to the request property /

    • breaking

      added the pattern property ^(.*)$ to the request property

    • breaking

      the / response's property type changed from string to no type for status

    • warning

      the / request property's maxLength was set to 3

    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional request property /

    • info

      added the new optional request property

    • info

      the request property default value en was added

    • info

      added the optional property / to the response with the status

    • info

      added subschema #1 subschema #2 to the / response property allOf list for the response status

  • ecd256fe0106Revision changes
    • info

      endpoint added