---
title: "Create payment method config"
method: POST
path: "/v1/payment_method_configs"
tags: ["Payment Method Configs"]
---

# Create payment method config

`POST /v1/payment_method_configs`

Create the configuration to store a payment method. The configuration contains basic information about the payment method such as an idempotency key and optional information such as billing contact and metadata. If the billing contact is provided in the payment method config, then the web component will not prompt for this data. These fields include country and postal code for a CARD payment method and name for an ACH payment method. This allows a payment method to be set up before collecting the sensitive payment method details (i.e the card number) via the web component. The merchant status must be `ACTIVE` to create a payment method config.

## Parameters

- `#/paths/~1v1~1payins/get/parameters/0` — unresolved $ref

## Request body

- Data — unresolved $ref

## Response `200`

OK

- object
  - `status` Status — unresolved $ref
  - `data` object
    - `payment_method_config_id` PaymentMethodConfigId — unresolved $ref
    - `platform_id` string — The unique platform identifier. Prefix is "plt" in production and "sbx_plt" in sandbox.
    - `billable_merchant_id` BillableMerchantId — unresolved $ref
    - `originating_merchant_id` string — The unique merchant identifier for the originating merchant, required for storing PayPal payment methods. Prefix is "mid" in production and "sbx_mid" in sandbox.
    - `platform` object
      - `platform_id` PlatformId — unresolved $ref
      - `name` string — The platform name.
    - `idempotency_key` IdempotencyKey — unresolved $ref
    - `billing_contact` BillingContact — unresolved $ref
    - `metadata` MethodMetadata — unresolved $ref
    - `payment_method` object, nullable — The minimal representation of the payment method created with the payment method config, if applicable. If no payment method has been created with the payment method config, `payment_method` will be `null`.
      - `payment_method_id` PaymentMethodId — unresolved $ref
    - `allow_bin_lookup` AllowBinLookup — unresolved $ref
    - `device_signature_mode` DeviceSignatureMode — unresolved $ref
    - `created_at` string, date-time — Date and time the payment method config was created at in UTC RFC 3339 format.
  - `errors` Errors — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `5XX` — unresolved $ref

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)