Skip to main content

79 docs tagged with "api"

View all tags

API Reference

Complete reference for the Omise API - Accept payments, manage customers, process refunds, and more with our RESTful API.

API Versioning

Learn how to manage Omise API versions, specify versions with the Omise-Version header, understand breaking vs non-breaking changes, handle deprecations, and maintain backward compatibility.

Authentication

Learn how to authenticate API requests using Omise API keys, understand the differences between public and secret keys, and implement secure authentication in your integration.

Balance API

Retrieve your account balance and available funds across all currencies with the Omise Balance API.

Capture a Charge

Capture a previously authorized charge to complete the payment and transfer funds to your account.

Create a Charge

Create a new charge to process a payment through credit cards, tokens, sources, or customer profiles.

Create a Customer

Create a customer profile to save payment methods for repeat billing. Store credit cards securely with the Omise Customers API.

Create a Link

Create a shareable payment link that can be used to request payments through any platform.

Create a Refund

Issue full or partial refunds for successful charges. Return funds to customers for order cancellations, returns, or billing adjustments.

Create a Source

Create a payment source for alternative payment methods like PromptPay, mobile banking, and QR codes.

Create a Token

Create a secure single-use token from credit card information. Tokenize card data safely with your public key.

Create a Transfer

Create a new transfer to send funds to your bank account or a verified third-party recipient.

Create Charge (with Chain)

Create a charge with destination parameter to enable marketplace payment splitting and automatic transfers.

Customers API

Manage customer profiles and saved payment methods. Store cards securely and charge customers with the Omise Customers API.

Delete a Card

Permanently remove a card from a customer's account with the Omise Cards API.

Delete a Customer

Permanently delete a customer and all associated cards from your account with the Omise Customers API.

Delete a Transfer

Permanently delete a transfer that has not yet been sent to the bank.

Error Handling

Learn how to handle Omise API errors gracefully, understand error response formats, status codes, common error types, and implement robust error handling strategies in your integration.

Expire a Charge

Set a pending charge to expire before customer completes payment. Works with certain payment methods like Alipay, DANA, GCash, KakaoPay, PayPay, and Touch 'n Go.

Idempotency

Learn how to safely retry Omise API requests without duplicating operations using idempotency keys. Understand idempotency headers, key formats, expiration, and best practices for reliable payment integrations.

List All Chains

Retrieve a paginated list of all sub-merchant chain accounts with filtering and sorting options.

List All Charges

Retrieve a paginated list of all charges with filtering and sorting options.

List All Customers

Retrieve a paginated list of all customers in your account with optional filtering and ordering using the Omise Customers API.

List All Disputes

Retrieve a paginated list of all disputes in your account. Filter by date range and sort order.

List All Events

Retrieve a paginated list of all events in your Omise account to monitor activity, debug webhooks, and track system events.

List All Links

Retrieve a paginated list of all payment links in your account with filtering and sorting options.

List All Receipts

Retrieve a paginated list of all daily receipts accumulating transaction and transfer fees.

List All Schedules

List all schedules in your Omise account. Filter and paginate through recurring payment schedules and automated transfers.

List All Transfers

Retrieve a paginated list of all transfers with filtering and sorting options.

List Closed Disputes

Retrieve a paginated list of all closed disputes with won or lost status. Analyze resolution outcomes and patterns.

List Open Disputes

Retrieve a paginated list of open disputes awaiting your response. Open disputes require evidence submission within 14-21 days.

List Pending Disputes

Retrieve a paginated list of pending disputes under review by card issuers. Resolution typically takes 60-90 days.

List Transactions

Retrieve a paginated list of transactions belonging to your account with optional filtering by date range and pagination parameters.

Pagination

Learn how to navigate large result sets efficiently using Omise API pagination with limit, offset, and list responses. Master pagination patterns for charges, customers, and other resources.

Rate Limiting

Learn about Omise API rate limits, understand rate limit headers, handle HTTP 429 responses, implement exponential backoff, and optimize your integration to stay within limits.

Refunds API

Issue full or partial refunds for credit card charges. Process returns and cancellations with the Omise Refunds API.

Retrieve a Card

Retrieve detailed information about a specific card attached to a customer with the Omise Cards API.

Retrieve a Charge

Retrieve details of an existing charge by its ID to check payment status and transaction details.

Retrieve a Customer

Retrieve complete customer profile information including saved cards, email, and metadata with the Omise Customers API.

Retrieve a Dispute

Get detailed information about a specific dispute including status, reason codes, evidence documents, and associated charge details.

Retrieve a Link

Fetch details for a specific payment link including charge history and usage status.

Retrieve a Refund

Get detailed information about a specific refund including status, amount, and transaction details.

Retrieve a Schedule

Retrieve a specific schedule by ID. Get details about recurring charges, transfers, occurrences, and schedule status.

Retrieve a Source

Retrieve information about an existing payment source. Check source status, type, and payment details.

Retrieve a Token

Retrieve information about an existing token. Check token status, card details, and usage.

Retrieve a Transaction

Retrieve details of a specific transaction by ID including amount, currency, direction, and source information.

Retrieve Account

Retrieve your Omise account details including email, country, currency, and supported payment methods.

Retrieve an Event

Get detailed information about a specific event including webhook delivery status and complete event data.

Retrieve an Occurrence

Retrieve a specific schedule occurrence. Get details about individual executions of recurring schedules including status, result, and error messages.

Retrieve Balance

Retrieve your Omise account balance including total, transferable, and reserve amounts across all currencies.

Retrieve Capability

Retrieve available payment methods, supported currencies, transaction limits, and account capabilities for your Omise account.

Retrieve Forex Rates

Retrieve current foreign exchange rates for multi-currency transactions. Get real-time conversion rates between supported currencies.

Reverse a Charge

Reverse a pre-authorized charge to release the hold on customer funds without capturing payment.

Search API

Search across all Omise resources including charges, customers, disputes, and more with the universal Search API.

Search Charges

Search and filter charges using the Omise Search API to find transactions by description, metadata, card details, and more.

Sources API

Accept alternative payment methods including PromptPay, mobile banking, QR codes, and more with the Omise Sources API.

Tokens API

Securely tokenize credit card information without handling sensitive card data on your servers. Learn how to use the Omise Tokens API for PCI-compliant payment processing.

Transactions API

View detailed transaction history and account activity with the Omise Transactions API for reconciliation and reporting.

Universal Search

Search across multiple resource types including charges, customers, disputes, recipients, and more with advanced filtering and query capabilities.

Update a Card

Update card details including cardholder name, expiration date, and billing address with the Omise Cards API.

Update a Charge

Update charge description and metadata for better record keeping and reconciliation.

Update a Customer

Update an existing customer's information including description, email, metadata, and default card with the Omise Customers API.

Update a Dispute

Update an open dispute by providing a response message and metadata to contest the chargeback.

Update a Recipient

Update recipient details including name, email, description, and metadata.

Update a Transfer

Update transfer information such as success status and failure details via webhook callback.

Update Account

Update your Omise account settings including webhook URLs, metadata export keys, and marketplace configuration.

Upload Dispute Document

Upload evidence documents to support your dispute response. Submit proof of delivery, customer communication, and transaction legitimacy.