Copy page

Errors

PAYMENT_METHOD_INVALID

PAYMENT_METHOD_INVALID

The payment method on the request is malformed or fails server-side validation (bad card number, missing CVV, unsupported method type).

Reserved error code — not currently emitted by any endpoint. Partners may begin handling it defensively; backend will start emitting once wired in.

Summary

Field	Value
HTTP status	400
errorCategory	payment
retryable	false

When This Fires

• POST /v1/marketplace/checkout/payments — the payment method payload fails validation before it reaches the processor.
• POST /v1/marketplace/orders/place — the saved payment method referenced by the order is structurally invalid.

Recommended Action

Re-prompt the user for payment details:

1. Show the payment form again with the failed fields highlighted.
2. Have the user re-enter (or pick a different saved card).
3. Resubmit.

This is not retryable with the same payload.

Example

Code
{
  "type": "https://developer.gett-tech.com/errors/PAYMENT_METHOD_INVALID",
  "title": "Bad Request",
  "status": 400,
  "detail": "The supplied payment method is invalid.",
  "instance": "/v1/marketplace/checkout/payments",
  "requestId": "req_abc123",
  "timestamp": "2026-04-27T14:30:00.000Z",
  "errorCode": "PAYMENT_METHOD_INVALID",
  "errorCategory": "payment",
  "retryable": false
}