Skip to main content

166 docs tagged with "api"

View all tags

Accept Dispute

Accept a dispute to concede to the customer's claim. This action is irreversible and results in the disputed amount being returned to the customer.

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.

Audits API

Access and search audit logs for comprehensive account activity tracking, including user actions, configuration changes, and system events.

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.

Bank Accounts

Bank account object reference for Recipients and Transfers. Understand the bank_account structure used in Omise payment disbursements.

Bulk Create Charge Schedules

Upload a CSV file to create multiple charge schedules at once. Ideal for migrating subscriptions or setting up recurring payments for large customer bases.

Bulk Delete Schedules

Permanently delete one or multiple charge schedules in a single operation. Deleted schedules will not execute any future occurrences.

Bulk Pause Schedules

Pause one or multiple active charge schedules in a single operation. Paused schedules will not execute until resumed.

Bulk Resume Schedules

Resume one or multiple paused charge schedules in a single operation. Resumed schedules will begin executing on their next scheduled occurrence.

Capability API

Discover available payment methods, supported currencies, transaction limits, and account features for your Omise integration.

Capture a Charge

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

Charge Schedules API

Create and manage recurring charge schedules in bulk using the Charge Schedules API. Upload CSV files to create multiple schedules, and pause, resume, or delete schedules in batch operations.

Close Dispute

Close a dispute after resolution. This endpoint is used to finalize a dispute that has been resolved through the chargeback process.

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 Dispute

Create a new dispute for a specific charge to initiate the chargeback process.

Create a Link

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

Create a Linked Account

Create a new linked account for payment method registration with the Omise Linked Accounts API.

Create a Refund

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

Create a Schedule

Create a new recurring schedule for charges or transfers. Set up automated payments with customizable frequency and timing.

Create a Source

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

Create a Sub-Merchant

Create a new sub-merchant under your platform account to enable payment processing for sellers and vendors.

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.

Create Routing Rule

Create a new routing group rule for payment routing to control how transactions are processed across different payment providers.

Create Webhook Secret

Create a new webhook signing secret to verify the authenticity of webhook events from Omise.

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 Schedule

Delete or cancel an existing schedule. Stop recurring charges or transfers by removing the schedule.

Delete a Transfer

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

Delete Dispute Document

Delete a document from a dispute. Remove evidence files that are no longer needed or were uploaded in error.

Delete Link

Delete a payment link to prevent further payments through that link.

Delete Webhook Secret

Delete a webhook signing secret from your account. Use this to remove old secrets during key rotation.

Destroy a Document

Delete a document from a dispute. Remove evidence files that are no longer needed or were uploaded in error.

Disputes API

Manage payment disputes (chargebacks) that customers file with their card issuing banks. Respond with evidence to contest disputes.

Documents API

Manage document files to help resolve disputes. Upload evidence such as receipts, delivery slips, and customer correspondence.

Download Bulk Status Report

Download a detailed CSV report showing the status of each row from a bulk charge schedule creation job, including error messages for failed rows.

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.

Events API

Access activity logs and webhook event history in your Omise account. Events represent actions like successful charges, failed payments, and disputes.

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.

Linked Accounts API

Manage linked accounts for your platform. Linked accounts represent connected sub-accounts that can process payments and receive payouts through your platform.

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 Refunds

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

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 API Versions

Lists all available API versions for the account including current default and supported versions.

List Charge Events

Retrieve a paginated list of events for a specific charge to monitor charge activity, debug webhooks, and track charge-related events.

List Closed Disputes

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

List Customer Schedules

List all schedules associated with a specific customer. View recurring charges, subscriptions, and automated payment schedules for a customer.

List Dispute Documents

List all documents attached to a dispute. Retrieve evidence files uploaded to support your dispute response.

List Documents

List all documents attached to a dispute. Retrieve evidence files uploaded to support your dispute response.

List Link Charges

List all charges created from a specific payment link with pagination support.

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 Recipient Schedules

List all schedules for a specific recipient. View recurring transfers and automated payment schedules associated with a recipient.

List Schedule Occurrences

List all occurrences (past and upcoming) for a specific schedule. View execution history and scheduled future events.

List Sub-Merchants

Retrieve a paginated list of all sub-merchants for your platform account with filtering options.

List Transactions

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

List Webhook Secrets

List all webhook signing secrets for your account to manage webhook verification and key rotation.

Monitor Bulk Creation Progress

Track the progress of a bulk charge schedule creation job. Get real-time status updates on row processing and completion.

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.

Payment Links+ API

Create and manage Payment Links+ using the dedicated API with templates, custom webhooks, and advanced features.

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.

Recipients API

Manage bank account destinations for transfers. Recipients represent verified bank accounts that can receive payouts from your Omise balance.

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 Document

Retrieve a specific document from a dispute. Get detailed information about an evidence file including download URL.

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 API Schema

Retrieve the OpenAPI schema for the Omise API to discover endpoints, parameters, and data structures.

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 Consent

Retrieve consent information for the account including consent status and configuration.

Retrieve Dispute Document

Retrieve a specific document from a dispute. Get detailed information about an evidence file including download URL.

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.

Routing Group Rules API

Manage payment routing rules to control how transactions are processed across different payment providers and acquirers.

Schedules API

Create and manage recurring payments and automated transfers on a schedule using the Schedules API.

Schema API

Access the OpenAPI schema for the Omise API to understand available endpoints, parameters, and data structures.

Search API

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

Search Audits

Search audit logs for account activity including user actions, configuration changes, and system events.

Search Charges

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

Search Customers

Search and filter customers using the Omise Search API to find customer records by email, description, metadata, and more.

Search Disputes

Search disputes by various criteria including status, reason code, amount, and date range using the Omise Search API.

Search Linked Accounts

Search and filter linked accounts using the Omise Search API to find accounts by name, email, status, and more.

Search Links

Search payment links by various criteria including title, amount, currency, and metadata.

Search Receipts

Search receipts by various criteria including date ranges, amounts, and other receipt attributes.

Search Recipients

Search recipients by various criteria including name, email, type, and metadata using the Omise Search API.

Search Refunds

Search and filter refunds using the Omise Search API to find refunds by metadata, amount, status, and more.

Search Sub-Merchants

Search and filter sub-merchants using the Omise Search API to find merchants by name, email, business details, and more.

Search Transfers

Search transfers by various criteria using the Omise Search API.

Sources API

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

Sub-Merchants API

Manage sub-merchants for marketplace and platform accounts. Sub-merchants represent sellers, vendors, or service providers that process payments through your platform.

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.

Transfers API

Transfer funds from your Omise account balance to recipient bank accounts. Transfers are the final step in the payout process.

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.

Update API Version

Update the default API version for the account to control response formats and available features.

Update Link

Update a payment link's properties such as title, description, and metadata.

Upload a Document

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

Upload Dispute Document

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

Webhooks Secrets API

Manage webhook signing secrets for your Omise account. Use secrets to verify that webhook events are genuinely from Omise and have not been tampered with.