Stripe API - список квитанций

Я использую API-интерфейс Stripe, и я хотел бы представить моему клиенту список их истории счетов и соответствующие квитанции.

Я не могу найти нигде в API-интерфейсе Stripe (https://stripe.com/docs/api?lang=php), который позволяет мне получить список клиентских квитанций. Что-то мне не хватает?

Ответ 1

Каждый счет-фактура включает свойство charge, которое содержит идентификатор последнего заряда. Это будет либо текущая/окончательная попытка платежа (для счетов-фактур, которые не были успешно оплачены), либо успешная оплата (для платных счетов-фактур).

Это позволяет вам легко использовать данные оплаты и счета-фактуры для предоставления квитанции пользователю, но "квитанция" сама по себе является скорее понятием на стороне приложения; его потребности и представление различаются в зависимости от приложения.

Как только у вас есть данные, вы можете представить квитанцию, как вам нравится.

В идеале я рекомендую кэшировать эти записи локально. Это почти безболезненно, если вы получаете webhooks. Затем вы можете моделировать (и искать!) Локальную учетную запись, которая наилучшим образом соответствует вашим потребностям, поэтому ваш клиент получает выгоду от очень быстрого выставления счетов, и все мы получаем выгоду от меньшей нагрузки на конечные точки Stripe API.

Ответ 2

Это действительно было бы не слишком сложно. Сначала вы получите все счета-фактуры:

https://stripe.com/docs/api?lang=php#invoice_object https://stripe.com/docs/api?lang=php#list_customer_invoices

Каждый счет-фактура имеет свойство "клиент", поэтому все, что вам нужно сделать, это выполнить поиск через счет-фактуру с идентификатором клиента, который соответствует вашему.

Каждый счет-фактура имеет свойство "receipt_number", поэтому вы должны быть добрым!