> ## Documentation Index > Fetch the complete documentation index at: https://docs.zeam.money/llms.txt > Use this file to discover all available pages before exploring further. # Send a cross-asset swap between own wallets > Cross-asset variant of POST /v1/payments/p2p/own: identical body plus a required receivingAssetCode that must differ from sendingAssetCode. Executed as a strict-send Stellar path payment — amount is denominated in sendingAssetCode and the received amount depends on the live rate at execution time. The destination may be the same wallet (a self-swap). Returns 202. ## OpenAPI ````yaml /api-reference/openapi.yaml post /payments/swap/own openapi: 3.1.0 info: title: Zeam API Gateway version: 1.0.0 description: > The Zeam API Gateway is the single, REST-based external surface for registered integrators. Every protected request carries a bearer access token (issued by the Zeam Auth Service) and the application secret header `x-zeam-auth`. The gateway verifies the token and resolves the caller's association server-side — you do not need to supply an association id header. Errors use RFC 7807 `application/problem+json`. license: name: Proprietary url: https://zeam.app contact: name: Zeam Platform Team url: https://zeam.app servers: - url: https://api.zeam.money/gw/v1 description: >- Zeam API Gateway. The sandbox and production environments share this base URL; your application's registration determines which one a request runs in. security: - BearerAuth: [] ZeamAuth: [] tags: - name: Auth description: Public token issuance. - name: Wallets description: Association wallets with embedded balances. - name: Assets description: Platform asset registry. - name: Beneficiaries description: Association beneficiaries and their payment destinations. - name: Connectors description: Connector discovery (Connect, surfaced as REST). - name: Quotes description: Off-ramp quotes. - name: Payments description: >- P2P transfers, swaps, and off-ramp cash-outs, plus the compliance reference lookups used when building an off-ramp. - name: Transactions description: Transaction records, the polling and history complement to webhooks. - name: Webhooks description: Association webhook registrations. paths: /payments/swap/own: post: tags: - Payments summary: Send a cross-asset swap between own wallets description: | Cross-asset variant of POST /v1/payments/p2p/own: identical body plus a required receivingAssetCode that must differ from sendingAssetCode. Executed as a strict-send Stellar path payment — amount is denominated in sendingAssetCode and the received amount depends on the live rate at execution time. The destination may be the same wallet (a self-swap). Returns 202. operationId: createSwapOwnPayment requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SwapOwnRequest' example: idempotencyKey: 1b4e28ba-2fa1-11d2-883f-0016d3cca427 transactionId: order-9942 externalReference: order-9942 walletId: 66666666-6666-6666-6666-666666666666 destinationWalletId: 99999999-9999-9999-9999-999999999999 sendingAssetCode: USDZ receivingAssetCode: ZARC amount: 100 responses: '202': description: Swap accepted for asynchronous processing. content: application/json: schema: $ref: '#/components/schemas/PaymentAccepted' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '422': $ref: '#/components/responses/ValidationError' '502': $ref: '#/components/responses/UpstreamError' '504': $ref: '#/components/responses/UpstreamTimeout' components: schemas: SwapOwnRequest: allOf: - $ref: '#/components/schemas/P2POwnRequest' - type: object required: - receivingAssetCode properties: receivingAssetCode: type: string description: Asset to receive — bare code. Must differ from sendingAssetCode. example: ZARC PaymentAccepted: type: object required: - transactionRecordId - status description: >- A 202 means the submission was accepted for asynchronous execution, not that it settled. Track completion with the Transactions routes or webhooks. properties: transactionRecordId: type: string format: uuid description: >- The transaction record id, used with GET /v1/transactions/{transactionId}. intentId: type: string description: Downstream intent id, when present. status: type: string description: Submission status; not a terminal transaction status. example: accepted isIdempotent: type: boolean description: >- True when this response replays a prior submission with the same idempotencyKey. message: type: string P2POwnRequest: type: object required: - idempotencyKey - transactionId - externalReference - walletId - destinationWalletId - sendingAssetCode - amount description: | Same-asset transfer between two of the caller's own wallets. Beneficiary fields are not accepted; use POST /v1/payments/p2p/beneficiary instead. properties: idempotencyKey: type: string description: >- Unique key for safe retries. Replaying it returns the original result. transactionId: type: string description: Your own transaction identifier. externalReference: type: string description: Your own reference, echoed on the transaction record. walletId: type: string format: uuid description: Source wallet. destinationWalletId: type: string format: uuid description: Destination wallet in your own association. sendingAssetCode: type: string description: >- Asset to send — bare code (e.g. USDZ). The gateway resolves the issuer from the asset registry. example: USDZ amount: type: number description: Amount to send denominated in sendingAssetCode.: null memo: type: string description: Optional Stellar memo. senderPhoneNumber: type: string description: Optional sender phone number. Problem: type: object required: - type - title - status description: RFC 7807 problem details. properties: type: type: string format: uri example: https://errors.zeam.app/validation-error title: type: string example: Validation Error status: type: integer example: 422 detail: type: string example: The 'amount' field must be a positive decimal. instance: type: string example: /v1/quotes requestId: type: string example: 01J8Z6K3QW9F2 errors: type: array items: type: object properties: field: type: string message: type: string responses: BadRequest: description: Malformed request. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' Unauthorized: description: Missing or invalid authentication. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' Forbidden: description: Authenticated but not permitted. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' ValidationError: description: Request failed validation. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' UpstreamError: description: A downstream service returned an unexpected error. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' UpstreamTimeout: description: A downstream service timed out. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: Access token issued by POST /v1/auth/token. ZeamAuth: type: apiKey in: header name: x-zeam-auth description: >- Application secret (the apiKey issued at registration), validated at the Kong edge. ````