Waffo Payment Provider

Add waffoPaymentProvider() to PaymentService.providers and configure the merchant ID, private key, product ID, and webhook public key.

await city.payment.method("waffo").invoke({ topup_amount_minor: 500, idempotency_key: "order_123" });

Use on_paid(record, fulfillment) for idempotent fulfillment from the order snapshot; free-amount topups credit the Primary Card. Paid status and wallet fulfillment are independent. Confirmation reads signed orderAmount and orderCurrency. The decimal amount string is converted exactly to integer minor units using the currency's precision, without floating-point rounding; malformed amounts, nonzero excess decimal places, and unsafe integers are rejected. Amount and currency must match the local order, and an external transaction ID is required. Missing, invalid, or mismatched facts cause a 422 failure and move the event to review. Request metadata is not proof of payment, and arbitrary tax or currency conversion is not automatically reconciled. Verified events are persisted and queued before acknowledgment. See Payment crediting for recovery and administrator replay.