---
title: "Make a payment to a booking order recently placed"
method: POST
path: "/payments"
tags: ["Payments"]
---

# Make a payment to a booking order recently placed

`POST /payments`

Given the `orderId`, `totalAmount` in specific `currency` along with `creditCard` information, a payment with an unique `paymentId` will be made and returned.

## Request body

- Payment
  - `paymentId` string — UUID
  - `createdAt` string, date-time — Creation date/time of the payment in ISO 8601 format (UTC)
  - `orderId` string, required — UUID
  - `currency` string, required
  - `totalAmount` number, required
  - `creditCard` CreditCard, required
    - `type` 'MASTERCARD' | 'VISA'
    - `number` string
    - `cvc` string
    - `expiryMonth` string
    - `expiryYear` string
    - `holderFirstName` string
    - `holderLastName` string
    - `address` string
    - `city` string
    - `zipCode` string
    - `countryCode` string — 2-letter ISO country code (alpha-2) as listed at https://en.wikipedia.org/wiki/ISO_3166-1

## Response `200`

OK

- PaymentResponse
  - `message` string — message returned by server side if there is any

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `409` — Conflict

## Changes

- **2021-08-16** `df240d562bd4` — 4 warning, 1 info
  - the response required property `payment/creditCard` became not write-only for the status `200`
  - the response required property `payment/creditCard` became not write-only for the status `400`
  - the response required property `payment/creditCard` became not write-only for the status `402`
  - the response required property `payment/creditCard` became not write-only for the status `409`
  - …1 more
- **2021-08-04** `a988ec9f3541` — 6 breaking, 2 warning, 6 info
  - removed the media type `text/plain` for the response with the status `400`
  - removed the media type `text/plain` for the response with the status `402`
  - removed the media type `text/plain` for the response with the status `409`
  - removed the required property `currency` from the response with the `200` status
  - …10 more
- **2021-07-20** `704267da2188` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/newpathfly/apis/virtual-interlining-api/changes/payments/post.md)

---

[API](https://skmtc.dev/newpathfly/apis/virtual-interlining-api.md) · [All operations](https://skmtc.dev/newpathfly/apis/virtual-interlining-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newpathfly/virtual-interlining-api/revisions/422128cc2430/schema)