---
title: "Authorize a payment request"
method: POST
path: "/api/v1/payments"
tags: ["payment"]
---

# Authorize a payment request

`POST /api/v1/payments`

Authorize a payment request.

## Request body

- PaymentReq — Contains the payment request information
  - `orderId` string — Order Identifier
  - `customer` CustomerInfoOnCard — Customer information required for payment processing
    - `firstName` string — Customer first name
    - `lastName` string — Customer last name
  - `address` Address
    - `id` string — Order identifier
    - `number` string — house of flat number
    - `residency` string — Socieity or building name
    - `street` string — street name
    - `city` string — city name
    - `state` string — state name
    - `country` string — country name
    - `pincode` string — postal code
  - `card` Card
    - `id` string — Order identifier
    - `cardNumber` string — Card Number
    - `expires` string — Expiration date
    - `cvv` string — CVV code
    - `userId` string
  - `amount` unknown

## Response `200`

For successful fetch.

- Authorization
  - `orderId` string — Order Identification
  - `time` string, date-time — Timestamp when this authorization was created
  - `authorized` boolean — Flat that specify whether the payment is authorized
  - `message` string — Approavl or rejection message
  - `error` string — Processing error description, if any

---

[API](https://skmtc.dev/packtpublishing/apis/sample-ecommerce-app.md) · [All operations](https://skmtc.dev/packtpublishing/apis/sample-ecommerce-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/packtpublishing/sample-ecommerce-app/revisions/51a26ae44206/schema)