# B2B Payments API overview Building with an AI agent? Start at https://docs.payme.io/agents.md ## Related - [Authentication and environments](/b2b-payments/getting-started/authentication) - [Errors](/b2b-payments/getting-started/errors) - [Run a B2B payment contract end to end](/b2b-payments/getting-started/contract-lifecycle) - [Contracts](/b2b-payments/contracts) B2B Payments moves money between two PayMe sellers. A **payment contract** sends a payment to another seller, or requests one, on a date you set, after the other seller approves it. A **wallet transfer** moves funds from one seller's PayMe balance to another's right away, without a contract. ## What the API covers | Section | What it covers | |---|---| | [Contracts](/b2b-payments/contracts) | [Create](/b2b-payments/contracts/post-contracts) and [list](/b2b-payments/contracts/get-contracts) payment contracts; [upload](/b2b-payments/contracts/post-contracts-files), [list](/b2b-payments/contracts/get-contracts-files), [replace](/b2b-payments/contracts/put-contracts-files) and [delete](/b2b-payments/contracts/delete-contracts-files) the files attached to a contract; [list the recipients](/b2b-payments/contracts/get-recipient) of earlier contracts. | | [Wallet Transfers](/b2b-payments/wallets) | [Transfer funds](/b2b-payments/wallets/post-generate-transfer) between two sellers of the same partner. | ## Read these first | # | Page | What you learn | |---|---|---| | 1 | [Authentication and environments](/b2b-payments/getting-started/authentication) | The sandbox and production hosts, and how contract calls and wallet transfers identify the seller. | | 2 | [Errors](/b2b-payments/getting-started/errors) | The error response, why you check `status_code` and not only the HTTP status, and the contract error codes. | | 3 | [Run a B2B payment contract end to end](/b2b-payments/getting-started/contract-lifecycle) | One contract from start to finish: payment method, creation, approval, callbacks, changes, cancellation and files. | The concepts behind contracts (payment methods, statuses and callbacks) are on [B2B payment contracts](/b2b-payments/contracts). ## Machine-readable docs Every page is available as Markdown by appending `.md` to its URL. Each API Reference section publishes one OpenAPI file at `/b2b-payments/
/openapi.json`, for example [`/b2b-payments/contracts/openapi.json`](/b2b-payments/contracts/openapi.json).