Docs
Payments API
Get accepted methods

Accepted Payment Methods

The Payments API processes payments using payment instruments such as credit cards or PayPal accounts. To learn more about Payments, see the Payments Overview.

The Get accepted payment methods endpoint returns information about the payment methods each configured payment gateway accepts. This information optimizes your implementation's likelihood of making successful payments requests that return errors solely when payment methods fail, without making API calls to the gateway prior to running the payment.

For a list of compatible payment gateways, as well as a guide through the API call sequence needed to make charges, see the Payments Overview.

This endpoint uses the X-Auth-Token header to authenticate. For an X-Auth-Token example request, see the related section in our Authentication article.

To learn more about authenticating Payments endpoints, locate the Authentication section at the top of each endpoint, then click Show Details.

Resources

Webhooks

Additional Payments endpoints

Get Accepted Payment Methods

GET /payments/methods

Request

Returns a list of accepted payment methods based on the order_id or checkout_id.

Notes

  • Use the Create an Order endpoint to generate the order_id.
  • Orders created will be set to incomplete order status.
  • The cart ID and checkout ID are the same.

Required Fields

  • order_id or checkout_id

Authentication

  • X-Auth-Token in header

Parameters

  • store_hash in path - string
  • Accept in header with default of application/json - string
    required
    The MIME type of the response body.
  • order_id in query - integer
    The ID of the subject order.
  • checkout_id in query - string
    The ID of the subject checkout; identical to the cart ID.

example

curl --request GET \
--url 'https://api.bigcommerce.com/stores/[store_hash]/v3/payments/methods' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-Auth-Token: {{token}}'

Response

Body

object | application/json

  • data    array[object]

  • meta    object

    Response metadata.

response

{
"data": [
{
"id": "bigcommerce.gift_certificate",
"name": "Gift Certificate",
"test_mode": false,
"type": "gift_certificate",
"supported_instruments": [],
"stored_instruments": []
},
{
"id": "bigcommerce.store_credit",
"name": "Store Credit",
"test_mode": false,
"type": "store_credit",
"supported_instruments": [],
"stored_instruments": []
},
{
"id": "stripe.card",
"name": "Stripe",
"test_mode": true,
"type": "card",
"supported_instruments": [
{
"instrument_type": "VISA",
"verification_value_required": true

See something you can improve? Edit this file on GitHub

Did you find what you were looking for?
OverviewGet Accepted Payment Methods