---
title: "Create Payin Intent"
method: POST
path: "/payin-intent"
tags: ["Payin Intent"]
---

# Create Payin Intent

`POST /payin-intent`

A Payin Intent reserves or authorizes funds for a payment that may be captured immediately or later. Use this endpoint to create a Payin Intent either standalone or linked to a Recurring Payin.
- Supports configurable capture behavior via `is_auto_capture` and `capture_delay` (max 14 days).

For more information about Payins, see the Payin APIs and the Hosted Checkout documentation.

## Request body

- object
  - `customer_id` string — Customer ID (customer_*)
  - `payin_method_name` string, required — Payin method name.
  - `card_tokenization_id` string — Card Tokenization ID (card_tkn_*)
  - `amount` number, required — Transaction amount
  - `currency` string, required — ISO 4217 currency code
  - `country` string — ISO 3166-1 alpha-2 country code
  - `webhook_url` string, uri — Webhook URL for intent updates
  - `capture_delay` integer — Delay in days before auto capture (1 to 7 Days)
  - `is_auto_capture` boolean — Whether to auto capture the payment
  - `redirect_url` string, uri, required — Redirect URL on success/failure if advanced_redirect_url not provided
  - `advanced_redirect_url` object
    - `completed_url` string, uri
    - `expired_url` string, uri
    - `cancelled_url` string, uri
    - `failed_url` string, uri
    - `awaiting_funds_url` string, uri
    - `payment_authorized_url` string, uri
  - `metadata` object — Custom key-value metadata

## Response `201`

Created

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/finmo/apis/finmo-api.md) · [All operations](https://skmtc.dev/finmo/apis/finmo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finmo/finmo-api/revisions/1a3073c93930/schema)