PaymentIntentLastPaymentError

Details of the latest failed payment attempt. Present only when an attempt failed, so treat it as optional. For an asynchronous authorization, it can appear on a later retrieval of the PaymentIntent rather than on the confirm response. Show message to the customer, and use decline_code and advice_code to decide what to do next.

type
Type: enum
required

The type of error returned.
values
- api_error
  
  The request could not be processed because of an internal Paypercut or upstream issue.
- card_error
  
  A payment attempt failed because of card, issuer, network, or authentication behavior.
- idempotency_error
  
  The request conflicts with an earlier request made with the same idempotency key.
- invalid_request_error
  
  The request is malformed, contains invalid parameters, or cannot be processed in its current state.
code
Type: string | null
max length:
5000

A short string identifying the error, such as card_declined.
decline_code
Type: string | null
max length:
5000

For card errors resulting from an issuer decline, a short string indicating the issuer's reason if one is available.
message
Type: string
max length:
40000
required

A customer-safe description of the failure that you can display directly.
message_code
Type: string | null
max length:
5000

Stable machine-readable localization key for message.
advice_code
Type: string | null
max length:
5000

A short string indicating how to proceed, such as try_again_later or do_not_try_again. Use it to decide whether to retry.
param
Type: string | null
max length:
5000

If the error is parameter-specific, the parameter related to the error.
network_decline_code
Type: string | null
max length:
5000

For payments declined by the network, an alphanumeric code indicating the reason the payment failed.
network_advice_code
Type: string | null
max length:
5000

For card errors resulting from an issuer decline, a network-provided advice code when available.
payment_method_type
Type: enumnullable

Type of payment method that a Checkout Session can accept.
values
- card
  
  Card payments, including supported card-based wallets.
- blik
  
  BLIK payments for eligible Polish zloty transactions.

Payment Intent

PaymentIntentCancellationReason