---
title: "Api V1 Donation Payment Record"
method: POST
path: "/api_v1_donation_payment_record"
---

# Api V1 Donation Payment Record

`POST /api_v1_donation_payment_record`

## Request

- Base URL: `https://jyotish-api.bda.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://jyotish-api.bda.ai/api_v1_donation_payment_record`
- Auth: none declared

Record a confirmed provider payment and unlock exactly one item.

This endpoint is for trusted webhook/Velo infrastructure, not browser
clients. General temple donations are recorded in the payment ledger but
never unlock dashboard items. Item entitlements require a profile identity.

## Request body

- DonationPaymentRecordRequest
  - `firebase_uid` string, nullable
  - `member_id` string, nullable
  - `session_id` string, nullable
  - `profile_id` string, nullable
  - `provider` string
  - `provider_payment_id` string, nullable
  - `provider_session_id` string, nullable
  - `provider_order_id` string, nullable
  - `payment_status` string
  - `amount` number
  - `amount_aud` number, nullable
  - `currency` string
  - `frequency` string
  - `campaign_id` string
  - `item_id` string, nullable
  - `item_label` string, nullable
  - `metadata` object, nullable
  - `raw_event` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service.md) · [All operations](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service/llms.txt) · [OpenAPI document](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service/revisions/90f241bf4009?raw)