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

# Make a payment to a booking order recently placed

`POST /booking/payments`

A `PaymentResponse` containing the `Payment` with an unique `paymentId` will be made and returned, given a `Payment` with `orderId`, `totalAmount` in specific `currency` along with `creditCard` information.

## 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
> This is an `PaymentResponse` containing the `Payment` with a unique `paymentId` that can be referred to when obtaining the `Payment`.

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

## Other responses

- `400` — Bad Request > Check if anything incorrect or missing in the given `Payment`. See `message` for any error message.
- `402` — Payment Required > The given `Payment` failed for some reason. See `message` for any error message.
- `409` — Conflict > The `Order` associated with the `orderId` in the given `Payment` might have already been paid.

## Changes

- **2021-11-12** `c3e56ec8db70` — 1 info
  - endpoint added
- **2021-07-20** `704267da2188` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/newpathfly/apis/virtual-interlining-api/changes/booking/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/5e3990fa16fa/schema)