Docs API Reference Contact Credit/bff/contact-credit/create

/bff/contact-credit/create

Adds a credit transaction to a contact. Optionally tag it with a per-organisation credit reason via reasonExternalId, and optionally attribute the internal cost to a branch via payerBranchSlug so the credit shows up in that branch's payer-credit ledger in addition to the customer history.

Contact CreditpostBffContact-creditCreate

Parameters

8 body

8 total

Body · 8

customerIdstringRequired

Contact external ID.

amountnumberRequired

Credit amount to add (positive or negative).

amountMoneynumber

Value in default currency. If omitted, defaults to same as amount (1:1).

descriptionstring

Optional free-form note for the transaction.

useExpirationbooleanRequired

Whether the credit has an expiration date.

expirationDatestring

Expiration date for the credit (ISO format).

reasonExternalIdstring

External ID of a configured credit reason (16 chars). Optional label tagging the transaction.

payerBranchSlugstring

Slug of the branch that internally bears the cost of this credit. Omit / empty = the organisation absorbs it (default).

Request

POST /bff/contact-credit/create

post

curl -X POST "https://api.bizkithub.com/bff/contact-credit/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "customerId": "example_customerId",
  "amount": 100,
  "amountMoney": 90,
  "description": "example_description",
  "useExpiration": false,
  "expirationDate": "2026-12-31",
  "reasonExternalId": "rsn1234567890abc",
  "payerBranchSlug": "gymroom-plzen"
}'

Response

JSON payload

{
  "success": true
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key