How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

BigCommerce Payment Actions API

The Payment Actions API from BigCommerce — 7 operation(s) for payment actions.

BigCommerce Payment Actions API is one of 161 APIs that BigCommerce publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Payment Actions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 8 operations across 7 paths, and defines 24 schemas. It is described by OpenAPI 3.0.0, at version 3.0.0.

Requests are made against a single base URL, https://api.bigcommerce.com/stores/{store_hash}/v3.

8 operations 7 paths 24 schemas 3 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
3.0.0
Base URL
https://api.example.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

BigCommerce Payment Actions API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Auth-Token (X-Auth-Token). By default, every request must be authenticated.

  • X-Auth-Token — OAuth scopes | UI Name | Permission | Parameter | |:--|:--|:-| | Information & Settings | read-only | storev2informationreadonly| | Information & Settings | mo…

Paths & Operations 8

Across 7 paths, the API surfaces 8 operations — 3 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Payment Actions 8
POST
/orders/{order_id}/payment_actions/capture
BigCommerce Capture order payment
captureOrderPayment 3 params → 201400404422502503504
POST
/orders/{order_id}/payment_actions/void
BigCommerce Void
voidOrderPayment 3 params → 201400404422502503504
POST
/orders/{order_id}/payment_actions/refund_quotes
BigCommerce Create a Refund Quote
createOrderRefundQuotes 3 params body → 201422
POST
/orders/{order_id}/payment_actions/refunds
BigCommerce Create a Refund
createOrderRefund 3 params body → 201422503
GET
/orders/{order_id}/payment_actions/refunds
BigCommerce Get Refunds for Order
getOrderRefunds 2 params → 200
GET
/orders/payment_actions/refunds/{refund_id}
BigCommerce Get a Refund
getOrderRefund 2 params → 200
GET
/orders/payment_actions/refunds
BigCommerce Get All Refunds
getOrdersRefunds 7 params → 200
POST
/orders/payment_actions/refund_quotes
BigCommerce Create Refund Quotes - BATCH
createOrdersRefundQuotes 1 param body → 201422503

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are Refund (10 properties), RefundQuote_Full (7 properties), RefundPayment (6 properties), PaymentOption (6 properties). Each schema is shown below with its type and property counts.

PaymentRequest
object
3 properties
errorDetailed_Full
object
1 property
metaEmpty_Full
object
Response metadata.
PostRefundQuotesRequest
array
Request body for batch refund quotes.
Meta
object
1 property
RefundQuote_Full
object
7 properties
RefundID_Get
object
2 properties
ItemsRefund
ErrorResponse
AdjustmentAmount
number
A negative or positive 2 decimal place rounded value that represents the difference between the refund amount requested in the refund quote and the actual amou…
QuantityBoundItem
object
Quantity Bound Item Type of refund item that capture refunding of items in the order that are of type quantity. ORDER PRODUCT GIFTWRAPPING SHIPPING HANDLING TAX
4 properties
Amount
number
A non-negative 2 decimal place rounded value that represents the amount that can be charged/refunded with payment providers.
RefundItem
object
5 properties
RefundQuote_Post
object
Request body for refund quotes.
1 property 1 required
AmountBoundItem
object
Amount Bound Item Type of refund item that capture refunding of items in the order that are of type amount. PRODUCT ORDER GIFTWRAPPING SHIPPING HANDLING TAX
5 properties
PaymentOption
object
6 properties
TaxExemptItem
object
Use this to refund a custom value at the order level. When itemtype is set to ORDER, tax is not re-calculated.
4 properties
Refund
object
10 properties
RefundPayment
object
6 properties
MerchantOverride
object
Merchant explicitly provided override based on their own calculation. This override gives merchants the flexibility to - bypass any tax correction due to tax r…
2 properties 2 required
RefundMethod
array
FailedQuoteError
object
Failed quote response.
3 properties
error_Base
object
Error payload for the BigCommerce API.
3 properties
RefundRequest_Post
object
Request body for refund requests.
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bigcommerce-payment-actions-api-openapi.yml Raw ↑

Other APIs BigCommerce publishes across the network.

Big Commerce Inventory
Big Commerce Locations
Big Commerce Customer Segmentation
Big Commerce Promotions
Big Commerce Promotion Settings
Big Commerce Pickup Methods
Big Commerce Storefront Pickup Options
Big Commerce Transactions
BigCommerce Abandoned Cart Emails API
BigCommerce Abandoned Cart Settings API
BigCommerce Abandoned Carts API
BigCommerce Abandoned Carts Settings API
Where this information came from

This is an independent, third-party profile of BigCommerce Payment Actions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.