COUNTCOUNT
Sign Up
Credit MemosApply multiple credits to an invoice

Apply multiple credits to an invoice

PATCH/partners/invoices/{uuid}/apply-multiple-credit-to-invoice

Applies one or more credit memos to the target invoice.

Path is the target invoice UUID. Each creditMemos[].id is a credit memo UUID.

HMAC signature + Bearer access token
Try this request
Invoices API

Path parameters

uuiduuidrequired

The target invoice UUID.

Request body

creditMemosarrayrequired

Credit memos to apply.

iduuidrequired

Credit memo UUID.

amountnumberrequired

Amount of credit to apply.

Responses

200Credits applied to the invoice.
400Invalid credit amount or memo not approved.
404Invoice or credit memo not found.
401Missing or invalid HMAC signature, expired timestamp, or invalid Bearer token. Troubleshoot
403The credential does not have access to this workspace or resource. Troubleshoot
429Rate limit exceeded (100 requests per minute per clientId). Retry after the Retry-After header. Troubleshoot
PATCHhttps://api.getcount.com/partners/invoices/{uuid}/apply-multiple-credit-to-invoice
Request
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const ACCESS_TOKEN = process.env.COUNT_ACCESS_TOKEN;

const method = 'PATCH';
const signingPath = '/invoices/3fa85f64-5717-4562-b3fc-2c963f66afa6/apply-multiple-credit-to-invoice';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "creditMemos": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "amount": 500
    }
  ]
};
const bodyString = JSON.stringify(body);

const bodyHash = crypto.createHash('sha256').update(bodyString).digest('hex');
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/partners/invoices/3fa85f64-5717-4562-b3fc-2c963f66afa6/apply-multiple-credit-to-invoice`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
  body: bodyString,
});

console.log(await response.json());
Response · 200
{
  "status": "success",
  "data": {
    "invoice": {
      "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
      "invoiceNumber": "INV-1042",
      "invoiceType": "invoice",
      "amountDue": 585,
      "total": 1085
    }
  }
}