---
title: "Create a Payment"
method: POST
path: "/v1/payments"
---

# Create a Payment

`POST /v1/payments`

## Request

- Base URL: `https://api.paymongo.com`
- URL: `https://api.paymongo.com/v1/payments`
- Auth: HTTP basic

Use secret API key to create a Payment

## Request body

- object
  - `data` object
    - `attributes` object
      - `amount` integer, required: amount of the Payment. 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. The amount is also considered as the gross amount.
      - `description` string: Description of the payment.
      - `currency` string, required: Three-letter ISO currency code, in uppercase. `PHP` is the only supported currency as of the moment.
      - `statement_descriptor` string: You can use this value as the complete description that appears on your customers’ statements. Your account's business name is the default value if not passed. The characters accepted are `alphanumeric, , . - ) ( @ + &, and space`.
      - `source` object, required
        - `id` string, required: id of a Source resource
        - `type` string, required: type of a Source resource. Possible value is `source`
      - `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. Keys that start with `PYM_` are reserved for internal use and are stripped on write.

## Response `200`

200

- object

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `f9ffaecbfe3d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paymongo/apis/paymongo-api/changes/v1/payments/post.md)

---

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