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 / PHP) release notes, see SDK changelog.| Version | Date | Changes |
|---|---|---|
| v1.3 | 2026-09-08 | Added seat add-on top-up topupInfo to subscription update requests and responses, and added topupDetails to subscription inquiry payment details; added payMethodCountry to subscription create, change, and inquiry payment information, and added cashierLanguage to subscription change requests; added purpose to Payout order data PayoutOrderData and removed feeStatus, mid, and subMid; PayeeInfo.payeeId is no longer marked as required; removed the Chargeback evidence field EvidenceField.evidenceFields from the public schema; renamed Chargeback and Reported Fraud list response page schemas to ApiPageResponse... |
| v1.3 | 2026-09-07 | Added public error codes A0055, B0014, B0015, and B0016 for subscription modification-in-progress and card status validation scenarios |
| v1.3 | 2026-08-24 | Added the Reported Fraud inquiry API POST /api/v1/fraud-report/list; added receiptTemplateId to order and subscription payment information; added merchantOrderId to Chargeback detail and list responses; chargebackId and originalOrderId are no longer marked as required in Chargeback inquiry requests |
| 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 |