session.attempt_failed

POST

A payment attempt was declined. While can_retry is true the buyer can try again on the hosted page; the last allowed decline is followed by session.failed.

Request Body^required

Media typeapplication/json

The session.attempt_failed event.

object

id

required

Event id (evt_…), stable across retries; also the X-Paymee-Webhook-Id header.

string

event

required

• session.attempt_failed - session.attempt_failed

string

Allowed values: session.attempt_failed

created_at

required

string format: date-time

livemode

required

False for events from test mode (sk_test_ keys).

boolean

data

required

The payment session, as every session.* and checkout.session.expired event carries it.

object

id

required

Payment session id (ps_…).

string

order_number

required

Paymee’s order number (PM-…).

string

merchant_reference

required

string

order_id

required

Empty when not given.

string

amount

required

Charged amount, decimal string (TND, 3 decimals).

string

currency

required

string

original

required

What you requested, and the exchange rate applied.

object

amount

required

Requested amount, as a decimal string at the requested currency’s precision.

string

currency

required

Requested ISO 4217 currency code.

string

rate

required

Exchange rate applied (1 original.currency = rate currency), six decimals. “1.000000” when no conversion.

string

description

required

string

status

required

• CREATED - CREATED
• PENDING - PENDING
• PROCESSING - PROCESSING
• SUCCEEDED - SUCCEEDED
• FAILED - FAILED
• EXPIRED - EXPIRED
• CANCELED - CANCELED

string

Allowed values: CREATED PENDING PROCESSING SUCCEEDED FAILED EXPIRED CANCELED

buyer

required

object

first_name

required

string

last_name

required

string

email

required

string

phone

required

Empty when not given.

string

items

required

The line items you sent, as sent.

Array<object>

object

key

additional properties

metadata

required

Your metadata, values as strings.

object

key

additional properties

string

completed_at

required

When the session reached a final status; null while it is open.

string | null format: date-time

attempt

required

object

id

required

Payment attempt id (pa_…).

string

attempt_number

required

1 for the first attempt.

integer

failure_code

required

The acquirer’s decline code. Informational; may change.

string

failure_message

required

The acquirer’s decline reason. Informational; may change.

string

attempts_count

required

Attempts made so far, this one included.

integer

attempts_remaining

required

integer

can_retry

required

True while the buyer can try again on this session.

boolean

Responses

200

Any 2xx within 10 seconds acknowledges the event; anything else is retried.