Skip to content

Get payment failed email

API v2 is in public beta: endpoints and fields can change before general availability. See the changelog

GET/preorders/templates/payment_failed

Costs 1 rate-limit point · Rate limits

Read the preorder payment-failed notification's email copy (it has no SMS). ?locale= picks the language (omit it for the shop default).

Change the copy with PATCH /preorders/templates/payment_failed. STOQ sends it when it can't charge the remaining balance of a partially paid preorder; the button opens Shopify's payment page for the order, and no email goes out when Shopify gives no such page. There is no shop-wide switch to turn it off. A language with no translation of a field returns the shop default's text for it.

Also searched aspayment failed email

Query parameters

  • localestring

    Language of the copy, such as fr or pt-BR. Omit for the shop's default language.

Returns

  • keystring
    Example: string
  • localestring
    Example: string
  • emailobject
    Show 7 child attributesHide child attributes
    • subjectstring
      Example: string
    • headingstring
      Example: string
    • bodystring
      Example: string
    • button_textstring
      Example: string
    • klaviyo_flow_namenull
    • klaviyo_flow_verifiedboolean
      Example: true
    • integrationnull

Errors

404
not_found

The path is valid but nothing with that id exists in this store.

422
validation_failed

The request failed validation.

Any request can also fail with auth_invalid (401) or rate_limited (429).

Every error has the same shape: see Errors and the list of error codes.

GET/preorders/templates/payment_failed
curl "https://app.stoqapp.com/api/v2/external/preorders/templates/payment_failed" \
  -H "X-Auth-Token: $STOQ_API_KEY"
Response
{
  "key": "string",
  "locale": "string",
  "email": {
    "subject": "string",
    "heading": "string",
    "body": "string",
    "button_text": "string",
    "klaviyo_flow_name": null,
    "klaviyo_flow_verified": true,
    "integration": null
  }
}