---
title: "Merchant webhook (called by Creem)"
method: POST
path: "/v1/billing/webhook/creem"
tags: ["billing"]
---

# Merchant webhook (called by Creem)

`POST /v1/billing/webhook/creem`

## Request

- Base URL: `https://api.niubai.vip` (the document declares no server; this is the origin it was published from)
- URL: `https://api.niubai.vip/v1/billing/webhook/creem`
- Auth: none required

Receives payment, subscription, refund and dispute events from Creem, verifies the `creem-signature` HMAC and applies them to the account. Not for clients: deliveries without a valid signature are refused.

## Response `200`

Successful Response

- WebhookAckOut
  - `status` string, required: `applied` or `ignored`.
  - `kind` string, nullable
  - `reason` string, nullable
  - `plan` string, nullable
  - `credit_pages` integer, nullable

## Other responses

- `400`: error.code is one of: invalid_request
- `401`: error.code is one of: unauthorized

---

[API](https://skmtc.dev/niubai/apis/pdf-edit-api-gateway.md) · [All operations](https://skmtc.dev/niubai/apis/pdf-edit-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/niubai/apis/pdf-edit-api-gateway/revisions/1ad0ce16ca04?raw)