Update payment option

Update an existing payment option referring to its ID.

Headers

NameTypeDescription
AuthorizationstringoAuth token with mandatory Bearer before it. Example: Bearer e***s0, where e***s0 should be replaced with your oAuth token.

Request

FieldTypeDescription
enabledbooleantrue to enable payment option to customers at checkout. false otherwise
configuredbooleanContains the payment method setup status. Read-only for in-built payment methods (where "appClientId": ""). Can be set for payment applications and will affect the payment method list in a store dashboard, see https://ecwid.d.pr/i/FpeCIb.
checkoutTitlestringPayment option title at checkout
checkoutDescriptionstringPayment option description at checkout
paymentSurcharges<PaymentSurcharges>Payment method fee added to the order as a set amount or as a percentage of the order total
instructionsForCustomer<InstructionsForCustomer>Text instructions for customers

PaymentSurcharges

FieldTypeDescription
typestringSupported values: ABSOLUTE, PERCENT
valuenumberSurcharge value

InstructionsForCustomer

FieldTypeDescription
instructionsTitlestringInstruction title
instructionsstringText of the instructions

Response

A JSON object of type 'UpdateStatus' with the following fields:

UpdateStatus

FieldTypeDescription
updateCountnumberThe number of updated options (1 or 0 depending on whether the update was successful)

Errors

In case of error, Ecwid responds with an error HTTP status code and, optionally, JSON-formatted body containing error description

HTTP codes

HTTP StatusDescriptionCode (optional)
400Request parameters are malformed
402The functionality/method is not available on the merchant plan
403Access token doesn't have update_store_profile scope
415Unsupported content-type: expected application/json or text/json

Error response body (optional)

FieldTypeDescription
errorMessagestringError message
errorCodestringError code
Language