feat(client): align php client with contracts v0.6.0

Author: marcohefti

CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-03-03
+
+### Added
+- Added request listing support in `RequestsApi`:
+  - `GET /v2/request` via `RequestsApi::list()`
+- Added `SecurePaymentsApi` domain support for:
+  - `GET /v2/secure-payments` via `SecurePaymentsApi::findByRequestId()`
+  - `POST /v2/secure-payments` via `SecurePaymentsApi::create()`
+  - `GET /v2/secure-payments/{token}` via `SecurePaymentsApi::getByToken()`
+
+### Changed
+- Synced bundled OpenAPI/contracts assets to `@marcohefti/request-network-api-contracts@0.6.0`.
+- Regenerated OpenAPI operation + schema manifest artifacts from the synced contracts.
+
+### Removed
+- Removed obsolete `PayeeDestinationApi` domain and related tests because `v0.6.0` contracts no longer include payee-destination endpoints.
+
+### Documentation
+- Updated README API coverage summary to include secure payments and request listing.
+
 ## [0.5.4] - 2026-02-20
 
 ### Added
@@ -105,6 +125,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version History
 
+- **0.6.x** - Contracts v0.6 alignment (secure payments + request listing, payee-destination removed)
 - **0.5.x** - Initial public release with full feature parity to TypeScript client
 - **0.x** - Pre-release versions, may contain breaking changes between minor versions
 - **1.0.0** - Planned stable release following strict SemVer

README.md

@@ -70,8 +70,8 @@ Instead of manually building HTTP requests and handling errors, this client prov
 
 ## What this client covers
 
-- PHP‑first `RequestClient` with facades for requests, payouts, payments, payer/compliance (v1+v2),
-  payee destination, client IDs, currencies (v1+v2), and legacy pay.
+- PHP-first `RequestClient` with facades for requests (including request listing), payouts, payments,
+  secure payments, payer/compliance (v1+v2), client IDs, currencies (v1+v2), and legacy pay.
 - Shared HTTP pipeline with retry, logging, and runtime validation driven by the synced OpenAPI spec.
 - Webhook utilities: signature verifier, typed event objects, parser, dispatcher, PSR‑15 middleware, and
   testing helpers that mirror the TypeScript webhook module.

generated/OpenApi/Operations.php

@@ -276,6 +276,23 @@ final class Operations
                     429
                 ]
             ],
+            'RequestControllerV2_listRequests_v2' => [
+                'method' => 'GET',
+                'path' => '/v2/request',
+                'tags' => [
+                    'Request',
+                    'V2/Request'
+                ],
+                'summary' => 'List requests',
+                'hasJsonRequest' => false,
+                'successStatuses' => [
+                    200
+                ],
+                'errorStatuses' => [
+                    400,
+                    429
+                ]
+            ],
             'RequestControllerV2_createRequest_v2' => [
                 'method' => 'POST',
                 'path' => '/v2/request',
@@ -290,7 +307,7 @@ final class Operations
                 ],
                 'errorStatuses' => [
                     400,
-                    404,
+                    403,
                     429
                 ]
             ],
@@ -689,43 +706,29 @@ final class Operations
                     429
                 ]
             ],
-            'PayeeDestinationController_getSigningData_v2' => [
-                'method' => 'GET',
-                'path' => '/v2/payee-destination/signing-data',
-                'tags' => [
-                    'V2/Payee Destination'
-                ],
-                'summary' => 'Get EIP-712 signing data with nonce',
-                'hasJsonRequest' => false,
-                'successStatuses' => [
-                    200
-                ],
-                'errorStatuses' => [
-                    429
-                ]
-            ],
-            'PayeeDestinationController_getActivePayeeDestination_v2' => [
+            'SecurePaymentController_findSecurePayment_v2' => [
                 'method' => 'GET',
-                'path' => '/v2/payee-destination',
+                'path' => '/v2/secure-payments',
                 'tags' => [
-                    'V2/Payee Destination'
+                    'V2/Secure Payment'
                 ],
-                'summary' => 'Get active payee destination for wallet',
+                'summary' => 'Find secure payment by request ID',
                 'hasJsonRequest' => false,
                 'successStatuses' => [
                     200
                 ],
                 'errorStatuses' => [
+                    404,
                     429
                 ]
             ],
-            'PayeeDestinationController_createPayeeDestination_v2' => [
+            'SecurePaymentController_createSecurePayment_v2' => [
                 'method' => 'POST',
-                'path' => '/v2/payee-destination',
+                'path' => '/v2/secure-payments',
                 'tags' => [
-                    'V2/Payee Destination'
+                    'V2/Secure Payment'
                 ],
-                'summary' => 'Create payee destination',
+                'summary' => 'Create a secure payment entry',
                 'hasJsonRequest' => true,
                 'successStatuses' => [
                     201
@@ -734,35 +737,21 @@ final class Operations
                     429
                 ]
             ],
-            'PayeeDestinationController_getPayeeDestination_v2' => [
+            'SecurePaymentController_getSecurePaymentByToken_v2' => [
                 'method' => 'GET',
-                'path' => '/v2/payee-destination/{destinationId}',
+                'path' => '/v2/secure-payments/{token}',
                 'tags' => [
-                    'V2/Payee Destination'
+                    'V2/Secure Payment'
                 ],
-                'summary' => 'Get payee destination by ID',
+                'summary' => 'Get secure payment data by token',
                 'hasJsonRequest' => false,
                 'successStatuses' => [
                     200
                 ],
                 'errorStatuses' => [
+                    403,
                     404,
-                    429
-                ]
-            ],
-            'PayeeDestinationController_deactivatePayeeDestination_v2' => [
-                'method' => 'DELETE',
-                'path' => '/v2/payee-destination/{destinationId}',
-                'tags' => [
-                    'V2/Payee Destination'
-                ],
-                'summary' => 'Deactivate payee destination',
-                'hasJsonRequest' => true,
-                'successStatuses' => [
-                    200
-                ],
-                'errorStatuses' => [
-                    400,
+                    409,
                     429
                 ]
             ]

generated/Validation/Schemas/index.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-02-20T18:48:24.099Z",
+  "generatedAt": "2026-03-03T11:21:34.027Z",
   "specPath": "specs/openapi/request-network-openapi.json",
   "entries": [
     {
@@ -54,22 +54,6 @@
       },
       "pointer": "/paths/~1v2~1client-ids~1{id}/put/responses/200/content/application~1json/schema"
     },
-    {
-      "key": {
-        "operationId": "PayeeDestinationController_createPayeeDestination_v2",
-        "kind": "request",
-        "variant": "application/json"
-      },
-      "pointer": "/paths/~1v2~1payee-destination/post/requestBody/content/application~1json/schema"
-    },
-    {
-      "key": {
-        "operationId": "PayeeDestinationController_deactivatePayeeDestination_v2",
-        "kind": "request",
-        "variant": "application/json"
-      },
-      "pointer": "/paths/~1v2~1payee-destination~1{destinationId}/delete/requestBody/content/application~1json/schema"
-    },
     {
       "key": {
         "operationId": "PayerV1Controller_createPaymentDetails_v1",
@@ -542,6 +526,15 @@
       },
       "pointer": "/paths/~1v2~1request~1{requestId}/get/responses/200/content/application~1json/schema"
     },
+    {
+      "key": {
+        "operationId": "RequestControllerV2_listRequests_v2",
+        "kind": "response",
+        "variant": "application/json",
+        "status": 200
+      },
+      "pointer": "/paths/~1v2~1request/get/responses/200/content/application~1json/schema"
+    },
     {
       "key": {
         "operationId": "RequestControllerV2_sendPaymentIntent_v2",
@@ -557,6 +550,41 @@
         "variant": "application/json"
       },
       "pointer": "/paths/~1v2~1request~1{requestId}/patch/requestBody/content/application~1json/schema"
+    },
+    {
+      "key": {
+        "operationId": "SecurePaymentController_createSecurePayment_v2",
+        "kind": "request",
+        "variant": "application/json"
+      },
+      "pointer": "/paths/~1v2~1secure-payments/post/requestBody/content/application~1json/schema"
+    },
+    {
+      "key": {
+        "operationId": "SecurePaymentController_createSecurePayment_v2",
+        "kind": "response",
+        "variant": "application/json",
+        "status": 201
+      },
+      "pointer": "/paths/~1v2~1secure-payments/post/responses/201/content/application~1json/schema"
+    },
+    {
+      "key": {
+        "operationId": "SecurePaymentController_findSecurePayment_v2",
+        "kind": "response",
+        "variant": "application/json",
+        "status": 200
+      },
+      "pointer": "/paths/~1v2~1secure-payments/get/responses/200/content/application~1json/schema"
+    },
+    {
+      "key": {
+        "operationId": "SecurePaymentController_getSecurePaymentByToken_v2",
+        "kind": "response",
+        "variant": "application/json",
+        "status": 200
+      },
+      "pointer": "/paths/~1v2~1secure-payments~1{token}/get/responses/200/content/application~1json/schema"
     }
   ]
 }

package.json

@@ -16,6 +16,6 @@
   "license": "MIT",
   "type": "commonjs",
   "devDependencies": {
-    "@marcohefti/request-network-api-contracts": "^0.5.0"
+    "@marcohefti/request-network-api-contracts": "^0.6.0"
   }
 }

specs/meta.json

@@ -1,8 +1,8 @@
 {
-  "generatedAt": "2026-02-20T18:47:31.512Z",
+  "generatedAt": "2026-03-03T11:21:33.788Z",
   "files": {
-    "openapi/request-network-openapi.json": "ffffcd0d757ef1158c642f8e738aee0e9d6cf3cae6545ad2e5b26ea870a19b50",
-    "openapi/request-network-openapi.meta.json": "de6d0b13e829cacc95c0952f50603aad769500737d1eddf0659bd99cab27c1f0",
+    "openapi/request-network-openapi.json": "badd3879103274935e52aa6a277c741c6ad22e801e38c1ee7f4e6b4b820544b5",
+    "openapi/request-network-openapi.meta.json": "73c3f8bc7e57073361f20f79aa11d26a472619be49b9439a7190f8f448a44a35",
     "webhooks/request-network-webhooks.json": "9438ad001651a8459a202d37e873516e05ffe6aeb29efead68bb58b948a5c494",
     "fixtures/webhooks/compliance-approved.json": "2a4a0d4acd7bb568c291aea43f669aecc717a23fd39b6c49e5a8934bfc1ef36c",
     "fixtures/webhooks/compliance-pending.json": "194c15cd4f4f67cf70d3f3a6ccb5eacc767bdfc43fd88f1d534f102f4568ca1e",

specs/openapi/request-network-openapi.json

@@ -1,6 +1,6 @@
 {
   "url": "https://api.request.network/open-api/openapi.json",
-  "fetchedAt": "2026-02-20T18:46:04.642Z",
+  "fetchedAt": "2026-03-03T11:14:08.930Z",
   "etag": null,
   "lastModified": null
 }