This page tracks the documentation and external contract revision series for the Waffo API. The
v1.3 values below are not values for the X-API-VERSION request header. Raw HTTP requests currently use 1.0.0; SDKs manage this header automatically, so do not set or override it. For SDK package (Node.js / Java / Go / Python) release notes, see SDK changelog.| Version | Date | Changes |
|---|---|---|
| v1.3 | 2026-08-21 | Added public error codes A0048, A0049, A0050, and A0054 for subscription plan-change states: in payment, cancelling, paid successfully, and another change request in progress |
| v1.3 | 2026-08-20 | Added the Point Topup (Waffo Point Topup) API: the GET /redirect signed redirect endpoint, POST /api/v1/gamepin/fulfillment-inquiry fulfillment inquiry, and the FULFILLMENT_RESULT_NOTIFY fulfillment result webhook |
| v1.3 | 2026-07-24 | Marked subscriptionManagementUrl as required in the subscription creation request; added currency, order amount limits, payment method type, and refund support fields to PayMethodDetail; currentStatus is no longer marked as required; restored mid and subMid in Payout order data PayoutOrderData and updated Payout payee account, description, and purpose guidance; card number, expiry, CVV, and cardholder name in AcqCardInfo are no longer marked as required |
| v1.3 | 2026-07-22 | Clarified userEmail guidance in order creation and subscription creation requests: the field is required; when a real email is unavailable, pass a unique user-ID-based fallback email; avoid placeholders or shared email addresses |
| v1.3 | 2026-07-20 | Updated OpenAPI nested object schema names to include parent request or response context, distinguishing shared objects such as MerchantInfo, PromotionInfo, and SubscriptionInfo to avoid component-name collisions |
| v1.3 | 2026-07-17 | Added public error code A0047 for checkout page language values that do not follow IETF BCP 47 |
| v1.3 | 2026-07-15 | Updated Payout order data PayoutOrderData: added the actual fee amount field actFeeAmount and removed the fields feeAmount, mid, and subMid |
| v1.3 | 2026-07-13 | Added the order capture API POST /api/v1/order/capture for manual capture confirmation in Auth-Capture mode |
| v1.3 | 2026-07-08 | Temporarily synced the public error code table by adding A0025, A0028, A0033-A0037, A0039-A0046, B0008-B0013, and D0002; increased the payMethodName maximum length for subscription creation and subscription changes from 24 to 256; added a subscription creation paymentInfo example; clarified the order creation payMethodProperties description |
| v1.2 | 2023-09-15 | Added the Direct Payment product type; updated error codes A0019, A0020, A0021 |
| v1.1 | 2023-05-31 | Added riskData Risk Control data; added AddressInfo and GoodsInfo for the BNPL payment method; updated error codes |
| v1.0 | 2023-03-15 | Initial release |