---
title: "POST /payment_intent"
method: POST
path: "/payment_intent"
tags: ["PaymentIntent"]
---

# POST /payment_intent

`POST /payment_intent`

## Request body

- CreatePaymentIntentDto
  - `amount` number, required — Transaction amount. Values must be passed in the base units of their currency. For example, $10.50 should be provided as `1050`.
  - `currency_code` string, required — Currency code of the amount to charge. This should be a 3-letter ISO-4217 currency code. For example, if you wish to charge 10 AED, you should pass AED. For more information on supported currencies, please visit the [supported currencies page](/supported-currencies)
  - `message` string — A message to be displayed to the user on the hosted payment page
  - `success_url` string — The URL to be called by the hosted web page when the payment is successful
  - `cancel_url` string — The URL to be called by the hosted web page when the payment is cancelled
  - `failure_url` string — Url where user will be redirected after failed payment
  - `test` boolean — Whether to create a test payment. Test payments do not require a payment method and can be used to test the payment flow. You won't be charged for this call. You can use [test cards](/test-cards) to test the payment flow.
  - `expiry` string — Unix timestamp in milliseconds, must be a future date
  - `allow_tips` boolean — Whether to allow tips for this payment intent

## Response `default`

Created payment intent

- PaymentIntentDto
  - `id` string, required — id of the payment intent
  - `account_id` string, required — Account which will receive payment
  - `amount` number, required — Transaction amount. Values must be passed in the base units of their currency. For example, $10.50 should be provided as `1050`.
  - `tip_amount` number, required — The amount of tips to be added to the payment intent
  - `fee_amount` number — The amount of fees paid for this payment intent
  - `currency_code` string, required — Currency code of the amount to charge. This should be a 3-letter ISO-4217 currency code. For example, if you wish to charge 10 AED, you should pass AED. For more information on supported currencies, please visit the [supported currencies page](/supported-currencies)
  - `created_at` string, required — Unix timestamp in milliseconds
  - `status` 'requires_payment_instrument' | 'requires_user_action' | 'pending' | 'completed' | 'failed' | 'canceled', required — Status of the transaction. You can find more details [here](/api-reference/payment-intent/index#fetching-a-payment-intent)
  - `operation_id` string, required — Unique client generated UUID. In case of retries provide the same operation_id
  - `message` string — A message to be displayed to the user on the hosted payment page
  - `redirect_url` string — The URL to be used to redirect the client to the hosted payment page
  - `embedded_url` string — The URL to be used to show embedded payment page with the payment widget
  - `success_url` string — The URL to be called by the hosted web page when the payment is successful
  - `cancel_url` string — The URL to be called by the hosted web page when the payment is cancelled
  - `latest_error` ErrorDto
    - `message` string, required — A human-readable error message
    - `code` string, required — HTTP error status code
  - `allow_tips` boolean — Whether tips are allowed for this payment intent

---

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