Release 11.12.2025

Documentation Updates

Shop Hosted Integration

The operationReference object structure in the H2H Integration for Instructions documentation has been updated.

Updated Structure:

{
  "operationReference": {
    "parameters": [
      {
        "label": "Reference",
        "value": "KT53386"
      },
      {
        "label": "Amount",
        "value": "10.00"
      },
      {
        "label": "Entity",
        "value": "db76f9cc-fbb0-4394-ac81-7b4fcfd6b2be"
      }
    ]
  }
}

Key Changes:

• type and metadata fields replaced with parameters array
• Parameter items now use label and value fields (previously id, type, value)
• The operationReference object has been moved to the payments array for orders and to the payoutTransactions array for payouts

See the Retrieve Order Details endpoint, Callback, Retrieve Payout Status endpoint, and Callback Payout documentation for the complete schema definition.

Antifraud Manual Review - reviewTimeout Field Correction

The reviewTimeout field unit has been corrected from hours to minutes. The field accepts values from 1 to 1440 minutes (24 hours).

See the Antifraud Manual Review guide, Retrieve Order Details endpoint, and Retrieve Payout Details endpoint documentation.

Standardized Error Responses

All API endpoints now include standardized error response codes documentation:

Status Code	Description
400	Invalid request parameters
401	Authentication failed. Verify that a valid Api-Access-Token is provided in the request headers
403	Access denied. The API token does not have permission to perform the requested operation
404	Resource not found
412	Precondition failed
500	Internal server error. An unexpected error occurred on the server side
502	Service unavailable. The upstream service is temporarily unreachable
503	Service unavailable. The server is temporarily unable to handle the request