---
title: "Create a PaymentIntent"
method: POST
path: "/v1/payment_intents"
---

# Create a PaymentIntent

`POST /v1/payment_intents`

Use secret API key to create a PaymentIntent

## Request body

- object
  - `data` object
    - `attributes` object
      - `amount` integer, required — amount to be collected by the PaymentIntent. A positive integer with minimum amount of 100. 100 is the smallest unit in cents. If you want to receive an amount of 1.00, the value that you should pass is 100. If you want to receive an amount of 1500.50, the value that you should pass is 150050.
      - `payment_method_allowed` string[], required — The list of payment method types that the PaymentIntent is allowed to use. Possible values are `qrph`, `brankas`, `card`, `dob`, `billease`, `gcash`, `grab_pay`, `shopee_pay`, `paymaya` for now.
      - `payment_method_options` object
        - `card` object — Specific configuration of the payment methods for the PaymentIntent.
          - `request_three_d_secure` string — This is the only current option for card payment method. Depending on the value, this option decides whether the card must require 3DS authentication or adjust depending on the default 3D Secure configuration of the card. Possible values are either any or automatic. any requires 3D Secure authentication if supported while automatic uses the default 3D Secure configuration of the card.
          - `installments` object
            - `enabled` boolean
      - `description` string — Description of the payment intent. The value saved here will also be saved to the Payments resource that will be generated on attach PaymentMethod to PaymentIntent endpoint.
      - `statement_descriptor` string — You can use this value as the complete description that appears on your customers’ statements for card and GCash transactions only. Your account's trade name is the default value if not passed. The characters accepted are `alphanumeric, , . - ) ( @ + &, and space`.
      - `currency` string, required — Three-letter ISO currency code, in uppercase. PHP is the only supported currency as of the moment.
      - `capture_type` string — Sets the capture type of the transaction. The default value is `automatic`. You can use our Pre-authorization and Capture API by setting this field to `manual`.
      - `setup_future_usage` object — Creating a payment intent with this attribute would connect the payment to our card vaulting feature. Take note that using this attribute would require that the payment method attached to this intent is a card type.
        - `session_type` string, required — Describes the behavior of card vaulting. For now the only possible value is `on_session`.
        - `customer_id` string, required — The ID of the customer.
      - `split_payment` object — This feature is only available for PayMongo Seeds merchants. This attribute configures the payment for splitting with associated merchant accounts.
        - `transfer_to` string — The merchant ID that will receive remaining net amount after the payment has been split.
        - `recipients` object[] — Defines the recipients and the split of the payment.
          - `merchant_id` string, required — The identifier for the associated recipient merchant.
          - `split_type` string, required — Determines the method of payment splitting. Possible values for now are `fixed` and `percentage_net`
          - `value` integer, required — Defines the value to be given to the recipient. For `fixed` split type, this field expects an integer in cents. For `percentage_net`, this field expects an integer representing a percentage in basis points (bps)
      - `metadata` object — A set of key-value pairs that you can attach to the resource. This can be useful for storing additional information about the object in a structured format. Only string values are accepted.

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/paymongo/apis/paymongo-api.md) · [All operations](https://skmtc.net/paymongo/apis/paymongo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymongo/paymongo-api/versions/c18f9a027b2c/schema)