---
title: "Create a PaymentMethod"
method: POST
path: "/v1/payment_methods"
---

# Create a PaymentMethod

`POST /v1/payment_methods`

Use public API key to create a PaymentMethod

## Headers

- `Content-Type` string

## Request body

- object
  - `data` object
    - `attributes` object
      - `type` string, required — The type of payment method. The possible values are `shopee_pay`, `qrph`, `brankas`, `card`, `dob`, `gcash`, `grab_pay`, `billease` and `paymaya`.
      - `expiry_seconds` integer — Seconds until the payment method expires after Attaching to a Payment Intent. `Only applicable for QR Ph and ShopeePay`
      - `details` object
        - `card_number` string — Credit/Debit Card number of the PaymentMethod. Required for `card` transactions.
        - `exp_month` integer — Expiry month of the Credit/Debit Card. Required for `card` transactions.
        - `exp_year` integer — Expiry year of the Credit/Debit Card. Required for `card` transactions.
        - `cvc` string — CVC of the Credit/Debit Card. Required for `card` transactions.
        - `bank_code` string — The bank code used. **Required only for `dob` payments**. The possible value for DOB is `bpi` `ubp`. The possible values for Brankas is `bdo`, `metrobank`, and `landbank`. For testing purposes use the value `test_bank_one` for BPI and `test_bank_two` for Unionbank.
      - `billing` object
        - `address` object
          - `line1` string — Line1 of the billing address information
          - `line2` string — Line2 of the billing address information
          - `city` string — City of the billing address information
          - `state` string — State of the billing address information
          - `postal_code` string — Postal Code of the billing address information
          - `country` string — Country of the billing address information. Possible values are ISO 3166-1 alpha-2 codes or two-letter country codes..
        - `name` string — Name of the billing information.
        - `email` string — E-mail address of the billing information.
        - `phone` string — Phone of the billing information.
      - `payment_method_option` object
        - `card` object
          - `installments` object
            - `plan` object
              - …
      - `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)