Refund
A Refund returns funds from a successful Charge to the original payment method. It can be full or partial. Its status tracks the processor's progress; pending or requires_action does not mean funds have been returned.
A Refund returns funds from a successful Charge to the original payment method. It can be full or partial. Its status tracks the processor's progress; pending or requires_action does not mean funds have been returned.
{ "id": "string", "object": "refund", "amount": 0, "chargeId": "string", "paymentIntentId": "string", "balanceTransactionId": "string", "failureBalanceTransactionId": "string", "externalRefundId": "string", "createdAt": "2019-08-24T14:15:22Z", "currency": "EGP", "presentmentDetails": { "amount": 0, "currency": "EGP", "exchangeRate": 0, "exchangeRateId": "string" }, "status": "PENDING", "reason": "DUPLICATE", "failureReason": "lost_or_stolen_card", "failureCode": "string", "failureMessage": "string", "pendingReason": "processing", "description": "string", "destinationDetails": { "type": "card", "card": { "reference": "string", "referenceStatus": "pending", "referenceType": "string", "type": "pending" }, "kiosk": { "reference": "string", "provider": "string" } }, "nextAction": { "type": "display_details", "displayDetails": { "emailSentAt": "2019-08-24T14:15:22Z", "emailSentTo": "string", "expiresAt": "2019-08-24T14:15:22Z" } }, "instructionsEmail": "string", "receiptNumber": "string"}Promotion Code
A Promotion Code is a customer-facing alphanumeric code (for example `SUMMER25`) that maps to a single Coupon. One Coupon can have many Promotion Codes, letting you run different campaigns (email vs. social, customer-specific codes, regional codes, …) against the same underlying discount. Customers enter the code at checkout to redeem the Coupon's discount. Promotion Codes can carry their own restrictions on top of the Coupon — a per-code redemption cap, an expiry date, or a binding to a specific Customer. You receive `promotion_code.created` and `promotion_code.updated` webhook events whenever a code is created or modified.
Tax Rate
A Tax Rate is a reusable tax you apply to invoice lines, such as 14% VAT. A rate is either inclusive (already inside the price) or exclusive (added on top). The percentage and the inclusive setting are fixed once the rate is created, so issued invoices never change. To change a rate, archive it and create a new one.