payment.failed

Occurs when a customer payment attempt fails.

WEBHOOK payment.failed

Example

{
  "id": "pay_123",
  "invoice_url": "https://solifyn.com/transactions/payments/pay_123/print",
  "customer": {
    "customer_id": "usr_123",
    "email": "[e-mail]",
    "name": "John Doe",
    "username": "johndoe"
  },
  "total_amount": 2900,
  "subtotal": 2900,
  "tax_amount": 0,
  "application_fee": 150,
  "amount_after_fees": 2750,
  "currency": "usd",
  "status": "paid",
  "created_at": "2026-05-22T08:00:00Z",
  "payment_method": "card",
  "product_cart": [
    {
      "id": "prod_123",
      "name": "SaaS Pro Access",
      "quantity": 1,
      "price": 2900,
      "pricingType": "one_time"
    }
  ],
  "refundable": true,
  "businessId": "biz_123",
  "businessName": "Acme SaaS Corp",
  "usdTotal": 30.6,
  "paidAt": "2026-05-22T08:05:00Z",
  "card_last_four": "4242",
  "card_network": "visa",
  "card_type": "visa",
  "billing": {
    "street": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94105",
    "country": "US"
  },
  "metadata": {},
  "order": {
    "filesSnapshot": [
      "<string>"
    ],
    "licenseKey": "FYN-XXXX-YYYY",
    "status": "completed"
  },
  "refunds": [
    {
      "refund_id": "ref_123",
      "payment_id": "pay_123",
      "amount": 1000,
      "currency": "usd",
      "status": "succeeded",
      "is_partial": true,
      "created_at": "2026-05-22T08:00:00Z",
      "reason": "requested_by_customer"
    }
  ],
  "billing_reason": "subscription_cycle"
}

Authorizations

Authorization · string · header · required

Authenticate requests using your standard bearer API key (e.g. YOUR_API_KEY).

Body

application/json

Represents an order (payment) processed under your business, containing customer, billing, product cart, and refund details.

id · string · required

Unique internal database identifier.

Example:

"pay_123"

invoice_url · string · required

The invoice print URL.

Example:

"https://solifyn.com/transactions/payments/pay_123/print"

customer · object · required

Customer details.

Show child attributes

total_amount · integer · required

Total paid amount in cents.

Example:

2900

subtotal · integer · required

Subtotal amount in cents.

Example:

2900

tax_amount · integer · required

Tax amount in cents.

Example:

0

application_fee · integer · required

Application fee in cents.

Example:

150

amount_after_fees · integer · required

Net amount after fees in cents.

Example:

2750

currency · string · required

Currency code.

Example:

"usd"

status · string · required

Current status of the payment.

Example:

"paid"

created_at · string<date-time> · required

Payment creation timestamp.

Example:

"2026-05-22T08:00:00Z"

payment_method · string · required

Payment method utilized.

Example:

"card"

product_cart · object[] · required

Products purchased in this order.

Show child attributes

refundable · boolean · required

Indicates whether the order is eligible for refund.

Example:

true

businessId · string · required

Business unique ID identifier.

Example:

"biz_123"

businessName · string · required

Business display title/name.

Example:

"Acme SaaS Corp"

usdTotal · number

Total paid amount converted to USD.

Example:

30.6

paidAt · string<date-time>

Payment completion/paid timestamp.

Example:

"2026-05-22T08:05:00Z"

card_last_four · string

Last four digits of card used.

Example:

"4242"

card_network · string

Card network/brand.

Example:

"visa"

card_type · string

Card type.

Example:

"visa"

billing · object

Billing address details.

Show child attributes

metadata · object

Custom metadata payload associated with this payment.

order · object

Order details snapshot.

Show child attributes

refunds · object[]

List of refunds associated with this payment.

Show child attributes

billing_reason · string

Billing reason detail.

Example:

"subscription_cycle"

Response

200

Webhook processed successfully.