feat: sync SDK with API changes

Author: github-actions[bot]

src/blindpay/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.0.1"
+__version__ = "2.1.0"
 
 from ._internal.exceptions import BlindPayError
 from .client import BlindPay, BlindPaySync
@@ -27,6 +27,8 @@
     TrackingTransaction,
     TransactionDocumentType,
     TransactionStatus,
+    VoucherStatus,
+    VoucherType,
 )
 
 __all__ = [
@@ -57,4 +59,6 @@
     "TrackingPartnerFee",
     "TrackingPayment",
     "TrackingTransaction",
+    "VoucherStatus",
+    "VoucherType",
 ]

src/blindpay/client.py

@@ -31,6 +31,7 @@
         VirtualAccountsResource,
         VirtualAccountsResourceSync,
     )
+    from blindpay.resources.vouchers.vouchers import VouchersResource, VouchersResourceSync
     from blindpay.resources.wallets.blockchain import BlockchainWalletsResource, BlockchainWalletsResourceSync
     from blindpay.resources.wallets.offramp import OfframpWalletsResource, OfframpWalletsResourceSync
     from blindpay.resources.webhooks.webhooks import WebhookEndpointsResource, WebhookEndpointsResourceSync
@@ -321,6 +322,12 @@ def fees(self) -> "FeesResource":
 
         return create_fees_resource(self._instance_id, self._api)
 
+    @cached_property
+    def vouchers(self) -> "VouchersResource":
+        from blindpay.resources.vouchers import create_vouchers_resource
+
+        return create_vouchers_resource(self._instance_id, self._api)
+
     @cached_property
     def upload(self) -> "UploadResource":
         from blindpay.resources.upload import create_upload_resource
@@ -539,6 +546,12 @@ def fees(self) -> "FeesResourceSync":
 
         return create_fees_resource_sync(self._instance_id, self._api)
 
+    @cached_property
+    def vouchers(self) -> "VouchersResourceSync":
+        from blindpay.resources.vouchers import create_vouchers_resource_sync
+
+        return create_vouchers_resource_sync(self._instance_id, self._api)
+
     @cached_property
     def upload(self) -> "UploadResourceSync":
         from blindpay.resources.upload import create_upload_resource_sync

src/blindpay/resources/__init__.py

@@ -12,6 +12,7 @@
 from .transfers import create_transfers_resource
 from .upload import create_upload_resource
 from .virtual_accounts import create_virtual_accounts_resource
+from .vouchers import create_vouchers_resource
 from .wallets import create_blockchain_wallets_resource, create_offramp_wallets_resource
 from .webhooks import create_webhook_endpoints_resource
 
@@ -31,6 +32,7 @@
     "create_transfers_resource",
     "create_upload_resource",
     "create_virtual_accounts_resource",
+    "create_vouchers_resource",
     "create_blockchain_wallets_resource",
     "create_offramp_wallets_resource",
     "create_webhook_endpoints_resource",

src/blindpay/resources/vouchers/__init__.py

@@ -0,0 +1,25 @@
+from .vouchers import (
+    CreateVoucherInput,
+    CreateVoucherResponse,
+    DeleteVoucherResponse,
+    ListVouchersResponse,
+    UpdateVoucherInput,
+    Voucher,
+    VouchersResource,
+    VouchersResourceSync,
+    create_vouchers_resource,
+    create_vouchers_resource_sync,
+)
+
+__all__ = [
+    "CreateVoucherInput",
+    "CreateVoucherResponse",
+    "DeleteVoucherResponse",
+    "ListVouchersResponse",
+    "UpdateVoucherInput",
+    "Voucher",
+    "VouchersResource",
+    "VouchersResourceSync",
+    "create_vouchers_resource",
+    "create_vouchers_resource_sync",
+]

src/blindpay/resources/vouchers/vouchers.py

@@ -0,0 +1,111 @@
+from typing import Any, List, Optional
+
+from typing_extensions import TypedDict
+
+from ..._internal.api_client import InternalApiClient, InternalApiClientSync
+from ...types import BlindpayApiResponse, Currency, PaginationMetadata, VoucherStatus, VoucherType
+
+
+class CreateVoucherInput(TypedDict):
+    code: str
+    type: VoucherType
+    currency: Currency
+    amount: float
+    description: Optional[str]
+    max_redemptions: Optional[int]
+    expires_at: Optional[str]
+    receiver_id: Optional[str]
+    metadata: Optional[Any]
+
+
+class CreateVoucherResponse(TypedDict):
+    id: str
+    code: str
+    type: VoucherType
+    status: VoucherStatus
+    currency: Currency
+    amount: float
+
+
+class UpdateVoucherInput(TypedDict, total=False):
+    description: Optional[str]
+    status: Optional[VoucherStatus]
+    max_redemptions: Optional[int]
+    expires_at: Optional[str]
+    metadata: Optional[Any]
+
+
+class Voucher(TypedDict):
+    id: str
+    code: str
+    description: Optional[str]
+    type: VoucherType
+    status: VoucherStatus
+    currency: Currency
+    amount: float
+    max_redemptions: Optional[int]
+    current_redemptions: int
+    expires_at: Optional[str]
+    receiver_id: Optional[str]
+    metadata: Optional[Any]
+    created_at: str
+    updated_at: str
+
+
+class ListVouchersResponse(TypedDict):
+    data: List[Voucher]
+    pagination: PaginationMetadata
+
+
+class DeleteVoucherResponse(TypedDict):
+    success: bool
+
+
+class VouchersResource:
+    def __init__(self, instance_id: str, client: InternalApiClient):
+        self._instance_id = instance_id
+        self._client = client
+
+    async def create(self, data: CreateVoucherInput) -> BlindpayApiResponse[CreateVoucherResponse]:
+        return await self._client.post(f"/instances/{self._instance_id}/vouchers", data)
+
+    async def list(self) -> BlindpayApiResponse[ListVouchersResponse]:
+        return await self._client.get(f"/instances/{self._instance_id}/vouchers")
+
+    async def get(self, voucher_id: str) -> BlindpayApiResponse[Voucher]:
+        return await self._client.get(f"/instances/{self._instance_id}/vouchers/{voucher_id}")
+
+    async def update(self, voucher_id: str, data: UpdateVoucherInput) -> BlindpayApiResponse[Voucher]:
+        return await self._client.patch(f"/instances/{self._instance_id}/vouchers/{voucher_id}", data)
+
+    async def delete(self, voucher_id: str) -> BlindpayApiResponse[DeleteVoucherResponse]:
+        return await self._client.delete(f"/instances/{self._instance_id}/vouchers/{voucher_id}")
+
+
+class VouchersResourceSync:
+    def __init__(self, instance_id: str, client: InternalApiClientSync):
+        self._instance_id = instance_id
+        self._client = client
+
+    def create(self, data: CreateVoucherInput) -> BlindpayApiResponse[CreateVoucherResponse]:
+        return self._client.post(f"/instances/{self._instance_id}/vouchers", data)
+
+    def list(self) -> BlindpayApiResponse[ListVouchersResponse]:
+        return self._client.get(f"/instances/{self._instance_id}/vouchers")
+
+    def get(self, voucher_id: str) -> BlindpayApiResponse[Voucher]:
+        return self._client.get(f"/instances/{self._instance_id}/vouchers/{voucher_id}")
+
+    def update(self, voucher_id: str, data: UpdateVoucherInput) -> BlindpayApiResponse[Voucher]:
+        return self._client.patch(f"/instances/{self._instance_id}/vouchers/{voucher_id}", data)
+
+    def delete(self, voucher_id: str) -> BlindpayApiResponse[DeleteVoucherResponse]:
+        return self._client.delete(f"/instances/{self._instance_id}/vouchers/{voucher_id}")
+
+
+def create_vouchers_resource(instance_id: str, client: InternalApiClient) -> VouchersResource:
+    return VouchersResource(instance_id, client)
+
+
+def create_vouchers_resource_sync(instance_id: str, client: InternalApiClientSync) -> VouchersResourceSync:
+    return VouchersResourceSync(instance_id, client)

src/blindpay/types.py

@@ -381,3 +381,7 @@ class TrackingPartnerFee(TypedDict):
 BankingPartner = Literal["cfsb", "citi", "hsbc", "jpmorgan"]
 
 PaymentMethod = Literal["ach", "wire", "pix", "spei", "transfers", "pse", "international_swift"]
+
+VoucherType = Literal["single_use", "multi_use", "time_limited"]
+
+VoucherStatus = Literal["active", "redeemed", "expired", "revoked"]