---
title: "Create payment intent"
method: POST
path: "/api/v1/payment-intent/"
tags: ["Payment Intent"]
---

# Create payment intent

`POST /api/v1/payment-intent/`

Create payment intent

## Request body

- PaymentIntentCreate
  - `product_id` string, uuid, required — Identifies a product, it can be a Widget or other product type
  - `product_type` 'widget'
  - `external_id` string, uuid, nullable — An external ID to identify a user. It can be the merchant's user ID or other tracking ID
  - `concept` string, nullable — Concept associated with the payment intent. This text will be reflected as a concept in the bank issuing the payment
  - `currency` string, required — Currency associated with the amount of the payment intent
  - `amount` string, decimal, required — Amount to be charged to a payment intent
  - `username` string, nullable — The payer username in the merchant store
  - `document_number` string, nullable — The document number of the payer with which you are registered in the merchant's store
  - `reference` string, nullable — Reference associated with the payment intent

## Response `201`

Payment intent created

- PaymentIntentCreateResponse
  - `intent_id` string, uuid, required
  - `external_id` string, uuid, nullable — An external ID to identify a user. It can be the merchant's user ID or other tracking ID
  - `concept` string, nullable — Concept associated with the payment intent. This text will be reflected as a concept in the bank issuing the payment
  - `currency` string, required — Currency associated with the amount of the payment intent
  - `amount` string, decimal, required — Amount to be charged to a payment intent
  - `username` string, nullable — The payer username in the merchant store
  - `document_number` string, nullable — The document number of the payer with which you are registered in the merchant's store
  - `reference` string, nullable — Reference associated with the payment intent

## Other responses

- `400` — Bad request (some invalid field)

---

[API](https://skmtc.net/prometeoapi/apis/account-validation-v2.md) · [All operations](https://skmtc.net/prometeoapi/apis/account-validation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prometeoapi/account-validation-v2/revisions/9c278fe91cbd/schema)