---
title: "POST /v2/peer-pay/sessions"
method: POST
path: "/v2/peer-pay/sessions"
tags: ["Peer Pay"]
---

# POST /v2/peer-pay/sessions

`POST /v2/peer-pay/sessions`

## Request

- Base URL: `https://api.peer.xyz`
- URL: `https://api.peer.xyz/v2/peer-pay/sessions`
- Auth: HTTP bearer

## Request body

- object
  - `shortCode` string, required
  - `payRemaining` boolean

## Response `200`

Payment session ready

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` object
    - `id` string, uuid, required
    - `shortCode` string, required
    - `fundingAmountUsd` string, required
    - `smsVerification` union, required
      - object
        - `status` 'not_started', required
      - object
        - `status` 'pending', required
        - `destinationHint` string, required
        - `otpExpiresAt` string, date-time, required
      - object
        - `status` 'verified', required
        - `destinationHint` string, required
        - `verificationExpiresAt` string, date-time, required
    - `rememberedPhoneNumber` string, nullable, required
    - `sandbox` boolean, required
    - `coinbaseOrderStarted` boolean, 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/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)