# Merchant API reference (/api-reference)

{/* @generated by apps/docs/scripts/generate-openapi.mjs from libs/api/openapi/generated/merchant-api.json. Do not edit directly. */}

Every page below comes from the same API definition that Recuut SDKs use. This is a lookup surface for an existing integration; use the [Direct HTTP integration](/guides/http/) for first-time account, policy, wallet, and receipt setup.

Send the test key only from your server as `Authorization: Bearer recuut_test_...`. The default API base URL is `https://api.recuut.com`. When **Try it** is enabled, add that test key with the global test-key control first; it stays in memory and is never written into the page. The paid request has two server calls: **Authorize resource access** before protected work, then **Complete a transaction** before releasing the result.

- [Authorize resource access](/api-reference/payments/payments.access/) — POST /merchant/v1/access
- [List access contracts](/api-reference/contracts/resources.contracts.list/) — GET /merchant/v1/contracts
- [List payers](/api-reference/payers/payments.payers.list/) — GET /merchant/v1/payers
- [Complete a free resource execution](/api-reference/resources/resources.complete_execution/) — POST /merchant/v1/resource-executions/{resource_execution_id}/complete
- [List resources](/api-reference/resources/resources.list/) — GET /merchant/v1/resources
- [List transactions](/api-reference/transactions/payments.transactions.list/) — GET /merchant/v1/transactions
- [Get a transaction](/api-reference/transactions/payments.transactions.get/) — GET /merchant/v1/transactions/{transaction_id}
- [Complete a transaction](/api-reference/transactions/payments.transactions.complete/) — POST /merchant/v1/transactions/{transaction_id}/complete