---
title: "Create a credit note"
method: POST
path: "/credit-notes"
tags: ["Credit Notes"]
---

# Create a credit note

`POST /credit-notes`

## Request

- Base URL: `https://app-sandbox.resolvepay.com/api`
- URL: `https://app-sandbox.resolvepay.com/api/credit-notes`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
- TypeScript: <https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/docs/credit-notes/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new credit note.

## Request body

- CreditNoteCreateRequest
  - `invoice_id` string, required: ID of the invoice
  - `amount` number, double, required: Amount of the credit note
  - `number` string: Number of the credit note
  - `reason_code` 'chargeback' | 'duplicate' | 'fraudulent' | 'requested_by_customer' | 'missing_remittance' | 'overpayment_on_invoice' | 'invoice_was_refunded' | 'double_payment_on_invoice' | 'missing_invoice_in_resolve' | 'credit_transfer' | 'other', required: Reason code for the credit note
  - `reason_message` string: Reason message for the credit note
  - `credit_note_url` string: URL for the publicly-accessible credit note PDF.

## Response `200`

An object containing the status of the credit note creation request.

- CreditNoteAction
  - `status` 'pending' | 'processing' | 'failed' | 'completed': Status of the credit note action

## Other responses

- `400`: Bad request error
- `401`: Unauthorized error
- `404`: Not found error
- `429`: Rate limit error

---

[API](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/revisions/5a1c75b8b404?raw)