---
title: "POST /v2/peer-pay/sessions/{sessionId}/transfer/prepare"
method: POST
path: "/v2/peer-pay/sessions/{sessionId}/transfer/prepare"
tags: ["Peer Pay"]
---

# POST /v2/peer-pay/sessions/{sessionId}/transfer/prepare

`POST /v2/peer-pay/sessions/{sessionId}/transfer/prepare`

## Request

- Base URL: `https://api.peer.xyz`
- URL: `https://api.peer.xyz/v2/peer-pay/sessions/{sessionId}/transfer/prepare`
- Auth: HTTP bearer

## Path parameters

- `sessionId` string, uuid, required

## Response `200`

Transfer prepared

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` union
    - object
      - `authorization` object, required
        - `version` 1, required
        - `method` 'POST', required
        - `url` string, uri, required
        - `headers` object, required
          - `privy-app-id` string, required
          - `privy-idempotency-key` string, required
          - `privy-request-expiry` string, required
        - `body` object, required
          - `method` 'eth_sendTransaction', required
          - `caip2` 'eip155:8453', required
          - `chain_type` 'ethereum', required
          - `sponsor` true, required
          - `reference_id` string, required
          - `params` object, required
            - `transaction` object, required
              - …
      - `transfer` unknown, required
    - object
      - `authorization` unknown, required
      - `transfer` object, required
        - `status` 'not_submitted' | 'pending' | 'confirmed' | 'failed', required
        - `transactionHash` string, nullable, required
  - `statusCode` number, required
  - `errorCode` string

## Changes

- **2026-09-13** `8d9a34e0e5d2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peer/apis/swagger-api/changes/v2/peer-pay/sessions/:sessionId/transfer/prepare/post.md)

---

[API](https://skmtc.dev/peer/apis/swagger-api.md) - [All operations](https://skmtc.dev/peer/apis/swagger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peer/apis/swagger-api/revisions/ef91955315e2?raw)