Receipts API
The Receipts API provides access to official tax receipts for successful charges. Receipts are automatically generated for paid transactions and can be retrieved for accounting, tax compliance, and customer records.
Overviewโ
Receipts provide:
- Official tax documentation - Full VAT receipts for Thai transactions
- Accounting records - Complete transaction details for bookkeeping
- Customer receipts - Shareable receipt URLs for customer records
- Compliance support - Meet tax and regulatory requirements
- Transaction history - Detailed record of all successful payments
How Receipts Workโ
- Automatic Generation - Receipts are automatically created when charges are paid
- Tax Compliance - Thai receipts include full VAT details and tax ID
- Permanent Records - Receipts are permanently stored for accounting purposes
- Downloadable - PDF receipts can be downloaded via API or Dashboard
- Customer Friendly - Share receipt URLs with customers for their records
Receipt Informationโ
Each receipt contains:
- Transaction details - Amount, currency, date, charge ID
- Tax information - VAT amount, tax ID (for Thai merchants)
- Merchant information - Your business name and details
- Customer information - Customer name and email (if provided)
- Payment method - Card type, last digits, or payment source
- Fee breakdown - Transaction fees and net amount
Use Casesโ
Tax Complianceโ
Retrieve receipts for tax filing and VAT reporting requirements.
Customer Supportโ
Send receipt PDFs to customers who need transaction records.
Accounting Integrationโ
Integrate receipt data into your accounting and bookkeeping systems.
Expense Managementโ
Provide receipts for business expense tracking and reimbursement.
Record Keepingโ
Maintain complete transaction records for audits and compliance.
Available Endpointsโ
- List All Receipts - GET /receipts
- Retrieve a Receipt - GET /receipts/:id
Receipt Availabilityโ
When Receipts Are Createdโ
- Receipts are created when a charge status is
successfulandpaid: true - One receipt per successful charge
- Receipts are available immediately after payment confirmation
When Receipts Are NOT Createdโ
- Pending charges (payment not yet completed)
- Failed charges
- Reversed pre-authorizations (uncaptured)
- Expired charges
Receipt Accessโ
Via APIโ
Use the Receipts API to programmatically retrieve receipt data and download URLs.
Via Dashboardโ
Access and download receipts from the Omise Dashboard under Charges or Receipts section.
Customer Accessโ
Share the receipt URL (download_uri) with customers for their records.
Best Practicesโ
โ Do Thisโ
- Store receipt IDs with transaction records for easy retrieval
- Include receipt URLs in customer confirmation emails
- Download receipts regularly for accounting backup
- Integrate with accounting software for automated bookkeeping
- Keep receipt records for tax compliance (minimum 7 years in Thailand)
- Provide receipts proactively to customers after successful payment
โ Don't Do Thisโ
- Don't assume all charges have receipts - only successful, paid charges
- Don't manually create receipts - they're automatically generated
- Don't delete receipt records - they're required for tax compliance
- Don't modify receipt data - receipts are official tax documents
- Don't share receipt URLs publicly - they contain transaction details
Thai VAT Receiptsโ
For merchants registered in Thailand:
- Receipts include full VAT breakdown
- Merchant tax ID is displayed
- Complies with Thai Revenue Department requirements
- Valid for tax deduction and VAT credit claims
Receipt Retentionโ
- Retention period: Receipts are retained indefinitely
- Access: Available via API and Dashboard at any time
- Compliance: Meets Thai tax law requirements (7+ year retention)
Related Resourcesโ
Need help? Check our Receipts Guide or contact support@omise.co