---
title: "Create a Payment Instrument"
method: POST
path: "/v1/payment-instruments"
tags: ["Payment Instruments"]
---

# Create a Payment Instrument

`POST /v1/payment-instruments`

## Headers

- `Merchant-Id` string, required

## Request body

- union
  - AmazonPayInstrumentRequest
    - `type` 'AMAZON_PAY', required — The AMAZON_PAY instrument type.
    - `details` AmazonPayDetails
      - `consumerEmail` string — The consumer's email for Amazon Pay
  - BancontactAccountInstrumentRequest
    - `type` 'BANCONTACT_ACCOUNT', required — The BANCONTACT_ACCOUNT instrument type.
    - `details` BancontactAccountDetails
      - `bin` string, required — The bank identification number
      - `last4Digits` string, required — The last 4 digits of the card
      - `expiryMonth` integer, required — The card expiration month
      - `expiryYear` integer, required — The card expiration year
      - `panAlias` string, required — The card PAN alias
  - BankAccountInstrumentRequest
    - `type` 'BANK_ACCOUNT', required — The BANK_ACCOUNT instrument type.
    - `details` BankAccountDetails
      - `accountNumber` string — The account number.
      - `holderName` string — The account holder name.
      - `iban` string — The IBAN.
      - `swiftCode` string — The SWIFT code.
      - `bankName` string — The bank name.
      - `bankCode` string — The bank code.
      - `debitMandateId` string — The reference id for a mandate that allows debit charges on the bank account.
  - CardNetworkTokenInstrumentRequest
    - `type` 'CARD_NETWORK_TOKEN', required — The CARD_NETWORK_TOKEN instrument type.
    - `details` CardNetworkTokenDetails, required
      - `brand` string
      - `holderName` string
      - `expiryMonth` integer
      - `expiryYear` integer
      - `tokenNumber` string
      - `eci` string
      - `cryptogram` string
  - KlarnaAccountInstrumentRequest
    - `type` 'KLARNA_ACCOUNT', required — The Klarna account instrument type.
    - `details` KlarnaAccountDetails
      - `authorizedPaymentMethod` string — Klarna authorized payment method
      - `billingCategory` string — Klarna billing category
  - MockInstrumentRequest
    - `type` 'MOCK', required — The MOCK instrument type.
    - `details` object — The MOCK payment details
  - PassthroughWalletInstrumentCreationRequest
    - `type` 'PASSTHROUGH_WALLET', required — The PASSTHROUGH_WALLET payment instrument can be associated to payments where the money is debited directly from the card or bank account linked to it
  - TwintWalletInstrumentRequest
    - `type` 'TWINT_WALLET', required — The TWINT_WALLET instrument type.
  - UpiAutoPayInstrumentRequest
    - `type` 'UPI_AUTOPAY', required — The UPI AutoPay instrument type.
    - `details` UpiAutoPayDetails
      - `uniqueMandateNumber` string — The UPI unique mandate number
  - object
    - `type` 'RAW_CARD', required — The `RAW_CARD` payment instrument type.
    - `details` RawCardDetails, required — The card details
      - `brand` string — The card brand.<br>The value must be provided in uppercase.
      - `number` string, required — The primary account number (PAN) of the card used for the payment.
      - `cvv` string — Card Verification Value used to authenticate the card during a payment.
      - `holderName` string, required — The full name of the cardholder as it appears on the card.
      - `expiryMonth` string, int32, required — The two-digit expiration month of the card.
      - `expiryYear` string, int32, required — The four-digit expiration year of the card.
    - `validate` InstrumentValidation
      - `currency` string, required — ISO 4217 3-letter currency code.
      - `taxIdentification` string — The consumer's tax identification number, like CUIT in Argentina, CPF in Brazil, RUT in Chile, NIF in Spain or Portugal, Numéro fiscal in France, and Codice Fiscale in Italy, or the equivalent tax identifier applicable in the consumer's country.

## Response `200`

OK

---

[API](https://skmtc.net/ppro/apis/payment-charges.md) · [All operations](https://skmtc.net/ppro/apis/payment-charges/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ppro/payment-charges/versions/112e8bb4c815/schema)