Skip to main content

Update Payment Link

POST /paymentlinks/update

This endpoint allows merchants to update existing payment links. Most properties of a payment link can be modified, though certain restrictions may apply depending on the link's current status and usage.

Test URL​

Send the request to the following URL:

https://checkout-api.staging.straumur.is/api/v1/paymentlinks/update

This call updates the specified payment link with the provided changes.

Request Example – Update Pay by Link​

{
  "terminalIdentifier": "1adfe4a1",
  "paymentLinkReference": "30001aylo2a",
  "themeKey": "441368-7a47f",
  "description": "Payment for PlayStation 2 HDMI Adapter.",
  "amount": 20000,
  "currency": "ISK",
  "returnUrl": null,
  "status": "Active",
  "culture": "is",
  "type": "PayByLink",
  "url": "https://pay.example.com/link/30001aylo2a",
  "createdAt": "2025-01-01T09:50:14.343503Z",
  "validUntil": null,
  "recurringProcessingModel": null,
  "visitCount": 69,
  "salesCount": 1,
  "maxSalesCount": null,
  "items": [
    {
      "name": "Playstation 2 Analog RCA/SCART to HDMI Adapter Low Latency",
      "quantity": 1,
      "amountWithoutDiscount": 25000,
      "amount": 20000,
      "unitPrice": 20000
    }
  ],
  "shopperInfo": [
    {
      "field": "Ssn",
      "requirementType": "Required",
      "prefilledValue": null
    }
  ]
}

Example Response – Success​

{
  "responseDateTime": "2025-01-04T09:50:14.343503Z",
  "responseIdentifier": "e3605f81-6b09-4ce1-83ad-5a8d49f3cd44"
}

Response Fields​

The response includes all payment link details with the updated status. Key changes after updating:

FieldTypeDescriptionExample
responseDateTimeStringThe date and time when the response was generated.2024-09-04T09:50:14.343503Z
responseIdentifierStringThe unique identifier for the response.7be7111c-2e8e-4cd4-a5ba-f15bdfd177c1

Error Response​

Error responses are standardized. For details, see Errors.

You can also find a detailed overview of our HTTP Status Codes.