Payment Overview

WickiePay supports two primary payment flows: Payment In (receiving crypto from customers) and Payment Out (sending crypto payouts to customers).

Payment Flow

                    Payment In (Receive)
Customer  ──────>  WickiePay HPP  ──────>  Merchant Settlement
                                                    |
                                              Auto-Conversion
                                              (Crypto → Fiat)

                    Payment Out (Payout)
Merchant  ──────>  WickiePay API  ──────>  Customer Wallet

Payment Types

Type	Direction	Use Case
IN	Customer → Merchant	E-commerce checkout, invoices, subscriptions
OUT	Merchant → Customer	Refunds, withdrawals, rewards

Payment Lifecycle

Every payment goes through these states:

PENDING  →  PROCESSING  →  COMPLETE
                ↓
           UNDERPAID / EXPIRED / CANCELLED

Status	Description
PENDING	Payment created, waiting for customer action
PROCESSING	Blockchain transaction detected, awaiting confirmations
COMPLETE	Payment confirmed and settled
UNDERPAID	Customer sent less than the required amount
EXPIRED	Payment window expired without receiving funds
CANCELLED	Payment was cancelled before completion

Integration Options

Hosted Payment Page (HPP)

The simplest integration — redirect customers to a WickiePay-hosted payment page.

Your Site  →  Create Payment (API)  →  Redirect to HPP URL  →  Customer Pays  →  Webhook Notification

Best for: Quick integration, minimal frontend work.

See Hosted Checkout for details.

Direct API Integration

Build your own payment UI using the WickiePay API directly.

Your Site  →  Create Payment (API)  →  Display Address/QR  →  Customer Pays  →  Webhook Notification

Best for: Custom checkout experience, embedded payments.

See Payment In and Payment Out for details.

Create a Payment

POST /api/v1/pay/summary
Content-Type: application/json

{
  "merchantId": "your-merchant-id",
  "type": "IN",
  "amount": 100.00,
  "currency": "EUR",
  "reference": "order-12345",
  "expiryMinutes": 30,
  "returnUrl": "https://yoursite.com/payment/complete"
}

Response:

{
  "uuid": "payment-uuid",
  "status": "PENDING",
  "displayCurrency": { "currency": "EUR", "amount": 100.00 },
  "address": {
    "address": "0x1234...abcd",
    "uri": "ethereum:0x1234...abcd?amount=0.05",
    "network": "ETHEREUM"
  },
  "redirectUrl": "https://pay.wickiepay.com/payment-uuid",
  "expiryDate": "2026-01-15T10:30:00Z"
}

Next Steps

• Payment In — Accept crypto payments
• Payment Out — Send crypto payouts
• Hosted Checkout — Use the Hosted Payment Page