Order Statuses

Orders in HytalePay go through different statuses as they're processed. Here's what each status means.

Status Types

Pending (Yellow)

The order has been created but payment hasn't been completed yet.

What to do:

• Wait for the customer to complete payment
• Orders may stay pending if the customer abandoned checkout
• Pending orders will expire after a set time

Completed (Green)

Payment was successful and the order is complete.

What happens:

• Money has been transferred to your PayPal account
• Items should be delivered to the player
• This is the ideal end state for orders

Refunded (Gray)

You've refunded the customer's payment.

When this happens:

• You manually issued a refund through PayPal
• The customer requested and you approved a refund
• Items should be removed from the player (if possible)

Chargeback (Red)

The customer disputed the charge with their bank or PayPal.

What this means:

• The customer claims they didn't authorize the purchase
• PayPal is investigating the dispute
• Funds may be held or reversed

Status Flow

Customer starts checkout
        ↓
    [PENDING]
        ↓
   Payment attempt
      /        \
   Success    Failure
      ↓          ↓
 [COMPLETED]  [PENDING]
      ↓
  (Optional)
    /    \
Refund  Dispute
   ↓       ↓
[REFUNDED] [CHARGEBACK]

Delivery Status

Separate from payment status, each item tracks delivery:

• Pending: Awaiting delivery
• Delivered: Successfully given to player
• Failed: Delivery attempt failed

Handling Different Statuses

Pending Orders

• Usually resolve themselves
• Check if customer completed PayPal checkout
• Contact customer if they seem stuck

Completed Orders

• Verify items were delivered
• No action needed if everything worked

Refunded Orders

• Remove items from player if possible
• Update any ranks or permissions
• Document the reason for records

Chargebacks

• Respond to PayPal's dispute inquiry
• Provide evidence of delivery
• Consider blocking repeat offenders