---
title: "Create Checkout"
method: POST
path: "/v1/payments/checkout"
tags: ["Payments", "Payments"]
---

# Create Checkout

`POST /v1/payments/checkout`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/payments/checkout`
- Auth: HTTP bearer

Create a checkout session for adding funds.

Creates a payment session with iyzico.
Returns checkout URL or embedded HTML for the payment form.

Args:
    body: Checkout request with amount and options

Returns:
    CheckoutResponse with session_id and checkout URL/HTML

## Request body

- CreateCheckoutRequest: Request to create a checkout session.
  - `amount` union, required: Amount in USD
    - number
    - string
  - `currency` string: Currency code
  - `success_url` string, nullable
  - `cancel_url` string, nullable
  - `save_card` boolean: Save card for future use
  - `provider` 'iyzico' | 'paddle', nullable: Payment provider (iyzico or paddle)

## Response `200`

Successful Response

- SrcPaymentModelsCheckoutResponse: Response with checkout session details.
  - `session_id` string, required
  - `checkout_url` string, nullable
  - `checkout_html` string, nullable
  - `provider` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/call2me/apis/call2me-api.md) · [All operations](https://skmtc.dev/call2me/apis/call2me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call2me/apis/call2me-api/revisions/3951f9b7e47d?raw)