---
title: "Record payment"
method: POST
path: "/v2/payment"
tags: ["Payment V2"]
---

# Record payment

`POST /v2/payment`

## Request body

- RecordPayment
  - `amount` number, required — Amount to be paid
  - `payment_date` string, required — Payment date [DD-MM-YYYY]
  - `bank_details` BankDetails
    - `account_number` string, required — Account Number
    - `ifsc` string, required — IFSC Code
    - `bank_name` string, required — Bank Name
    - `branch` string, required — Branch
  - `payment_mode` 'Cash' | 'Cheque' | 'UPI' | 'Card' | 'Net Banking' | 'paylater' | 'cardless_emi' | 'EMI' | 'TDS' | 'Credits', required — Payment mode
  - `notes` string — Notes, will be shared with the customer
  - `send_sms` boolean — Send SMS, customer will be notified through SMS
  - `send_email` boolean — Send Email, customer will be notified through Email
  - `exclusive_notes` string — Exclusive Notes for internal purpose
  - `customer` string, required — Customer ID
  - `documents` DocumentsList[] — Documents to be settled, if any
    - `amount_paying` number, required — Amount to be settled for the document
    - `hash_id` string, required — Document Hash ID

## Response `200`

Payment recorded successfully

- PaymentResponseV2
  - `success` boolean — Success flag
  - `message` string — Response message
  - `error_code` string — Error Code
  - `errors` object — Errors
  - `data` PaymentResponseData
    - `serial_number` string — Serial Number

## Other responses

- `400` — Error in recording payment
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/getswipe/apis/swipeapi.md) · [All operations](https://skmtc.dev/getswipe/apis/swipeapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getswipe/swipeapi/revisions/80fcaf1a3463/schema)