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

# Record payment

`POST /v1/payment`

## Request

- Base URL: `https://app.getswipe.in/api/partner`
- URL: `https://app.getswipe.in/api/partner/v1/payment`
- Auth: HTTP bearer

**v1 is deprecated — use the v2 endpoint instead.** Records a payment received from a customer. Optionally settle specific documents by pairing each `hash_id` with an `amount_paying` — partial settlement is supported and the document's payment status tracks what remains. Non-cash payment modes need a bank account configured on your account, otherwise the request fails with `MISSING_BANK_ACCOUNT`. Set `send_sms` or `send_email` to notify the customer.

## 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' | 'Opening Balance', 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

- PaymentResponse
  - `success` boolean: Success flag
  - `message` string: Response message

## Other responses

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

## Changes

- **2026-11-03** `0bcdbc62187b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getswipe/apis/swipeapi/changes/v1/payment/post.md)

---

[API](https://skmtc.dev/getswipe/apis/swipeapi.md) - [All operations](https://skmtc.dev/getswipe/apis/swipeapi/llms.txt) - [OpenAPI document](https://skmtc.dev/getswipe/apis/swipeapi/revisions/0bcdbc62187b?raw)