{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://roas.my/developers/webhooks.json","title":"ROAS.my outgoing webhook payload","description":"Payload sent by ROAS.my to merchant-owned HTTPS endpoints.","oneOf":[{"type":"object","required":["schemaVersion","event","eventId","occurredAt","test","order"],"properties":{"schemaVersion":{"const":1},"event":{"const":"order.created"},"eventId":{"type":"string","minLength":1},"occurredAt":{"type":"string","format":"date-time"},"test":{"type":"boolean"},"order":{"type":"object","required":["code","status","paymentStatus","fulfillmentStatus","paymentMethod","customer","package","orderBumps","amount","tracking","utm","createdAt","updatedAt"],"properties":{"code":{"type":"string"},"status":{"enum":["pending","paid","confirmed","shipped","failed","cancelled"]},"paymentStatus":{"enum":["pending","cod","paid","failed"]},"fulfillmentStatus":{"enum":["unfulfilled","processing","shipped","completed"]},"paymentMethod":{"enum":["cod","fpx","bank_transfer"]},"customer":{"type":"object","additionalProperties":true},"package":{"type":"object","required":["slug","name","sku","quantity","bundleItems"],"description":"Checkout/package metadata plus physical selection snapshots. package.sku is not an additional inventory line.","properties":{"slug":{"type":"string"},"name":{"type":"string"},"sku":{"type":"string","description":"Checkout/package identifier; do not add it to physical item quantities."},"quantity":{"type":"integer","minimum":1},"variant":{"type":["object","null"],"description":"Selected physical Variant and exact SKU, when applicable."},"bundleItems":{"type":"array","description":"Physical inventory SKU snapshots with quantities.","items":{"type":"object"}}},"additionalProperties":true},"orderBumps":{"type":"array","items":{"type":"object"}},"orderBump":{"type":["object","null"]},"amount":{"type":"object","required":["subtotalSen","shippingSen","codFeeSen","totalSen","currency"],"additionalProperties":false,"properties":{"subtotalSen":{"type":"integer"},"shippingSen":{"type":"integer"},"codFeeSen":{"type":"integer"},"totalSen":{"type":"integer"},"currency":{"const":"MYR"}}},"tracking":{"type":"object","additionalProperties":true},"utm":{"type":"object","additionalProperties":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"additionalProperties":false}},"additionalProperties":false},{"type":"object","required":["schemaVersion","event","eventId","occurredAt","test","order"],"properties":{"schemaVersion":{"const":1},"event":{"const":"order.updated"},"eventId":{"type":"string","minLength":1},"occurredAt":{"type":"string","format":"date-time"},"test":{"type":"boolean"},"order":{"type":"object","required":["code","status","paymentStatus","fulfillmentStatus","paymentMethod","customer","package","orderBumps","amount","tracking","utm","createdAt","updatedAt"],"properties":{"code":{"type":"string"},"status":{"enum":["pending","paid","confirmed","shipped","failed","cancelled"]},"paymentStatus":{"enum":["pending","cod","paid","failed"]},"fulfillmentStatus":{"enum":["unfulfilled","processing","shipped","completed"]},"paymentMethod":{"enum":["cod","fpx","bank_transfer"]},"customer":{"type":"object","additionalProperties":true},"package":{"type":"object","required":["slug","name","sku","quantity","bundleItems"],"description":"Checkout/package metadata plus physical selection snapshots. package.sku is not an additional inventory line.","properties":{"slug":{"type":"string"},"name":{"type":"string"},"sku":{"type":"string","description":"Checkout/package identifier; do not add it to physical item quantities."},"quantity":{"type":"integer","minimum":1},"variant":{"type":["object","null"],"description":"Selected physical Variant and exact SKU, when applicable."},"bundleItems":{"type":"array","description":"Physical inventory SKU snapshots with quantities.","items":{"type":"object"}}},"additionalProperties":true},"orderBumps":{"type":"array","items":{"type":"object"}},"orderBump":{"type":["object","null"]},"amount":{"type":"object","required":["subtotalSen","shippingSen","codFeeSen","totalSen","currency"],"additionalProperties":false,"properties":{"subtotalSen":{"type":"integer"},"shippingSen":{"type":"integer"},"codFeeSen":{"type":"integer"},"totalSen":{"type":"integer"},"currency":{"const":"MYR"}}},"tracking":{"type":"object","additionalProperties":true},"utm":{"type":"object","additionalProperties":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"additionalProperties":false}},"additionalProperties":false},{"type":"object","required":["schemaVersion","event","eventId","occurredAt","test","order"],"properties":{"schemaVersion":{"const":1},"event":{"const":"order.payment_failed"},"eventId":{"type":"string","minLength":1},"occurredAt":{"type":"string","format":"date-time"},"test":{"type":"boolean"},"order":{"type":"object","required":["code","status","paymentStatus","fulfillmentStatus","paymentMethod","customer","package","orderBumps","amount","tracking","utm","createdAt","updatedAt"],"properties":{"code":{"type":"string"},"status":{"enum":["pending","paid","confirmed","shipped","failed","cancelled"]},"paymentStatus":{"enum":["pending","cod","paid","failed"]},"fulfillmentStatus":{"enum":["unfulfilled","processing","shipped","completed"]},"paymentMethod":{"enum":["cod","fpx","bank_transfer"]},"customer":{"type":"object","additionalProperties":true},"package":{"type":"object","required":["slug","name","sku","quantity","bundleItems"],"description":"Checkout/package metadata plus physical selection snapshots. package.sku is not an additional inventory line.","properties":{"slug":{"type":"string"},"name":{"type":"string"},"sku":{"type":"string","description":"Checkout/package identifier; do not add it to physical item quantities."},"quantity":{"type":"integer","minimum":1},"variant":{"type":["object","null"],"description":"Selected physical Variant and exact SKU, when applicable."},"bundleItems":{"type":"array","description":"Physical inventory SKU snapshots with quantities.","items":{"type":"object"}}},"additionalProperties":true},"orderBumps":{"type":"array","items":{"type":"object"}},"orderBump":{"type":["object","null"]},"amount":{"type":"object","required":["subtotalSen","shippingSen","codFeeSen","totalSen","currency"],"additionalProperties":false,"properties":{"subtotalSen":{"type":"integer"},"shippingSen":{"type":"integer"},"codFeeSen":{"type":"integer"},"totalSen":{"type":"integer"},"currency":{"const":"MYR"}}},"tracking":{"type":"object","additionalProperties":true},"utm":{"type":"object","additionalProperties":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"additionalProperties":false}},"additionalProperties":false},{"type":"object","required":["schemaVersion","event","eventId","occurredAt","test","checkout"],"properties":{"schemaVersion":{"const":1},"event":{"const":"checkout.abandoned"},"eventId":{"type":"string","minLength":1},"occurredAt":{"type":"string","format":"date-time"},"test":{"type":"boolean"},"checkout":{"type":"object","required":["customer","package","paymentMethod","source","createdAt","lastActivityAt","resumeUrl"],"properties":{"customer":{"type":"object","additionalProperties":true},"package":{"type":"object","additionalProperties":true},"paymentMethod":{"type":"string"},"source":{"type":"object","additionalProperties":true},"createdAt":{"type":"string","format":"date-time"},"lastActivityAt":{"type":"string","format":"date-time"},"resumeUrl":{"type":"string","format":"uri"}},"additionalProperties":false}},"additionalProperties":false}],"examples":[{"schemaVersion":1,"event":"order.created","eventId":"order.created:ord_01","occurredAt":"2026-08-22T04:10:00.000Z","test":false,"order":{"code":"AH-ABC123-1001","status":"confirmed","paymentStatus":"cod","fulfillmentStatus":"unfulfilled","paymentMethod":"cod","customer":{"name":"Nur Aisyah","phone":"60123456789","email":"aisyah@example.com","address1":"12 Jalan Melur","address2":"Taman Indah","postcode":"40000","city":"Shah Alam","state":"Selangor","customFields":{}},"package":{"slug":"pakej-kombo","name":"Pakej Kombo","sku":"CHECKOUT-KOMBO","quantity":1,"variant":null,"bundleItems":[{"componentId":"sku_01","name":"Produk A","sku":"PROD-A","quantity":2,"role":"choice"}]},"orderBumps":[],"orderBump":null,"amount":{"subtotalSen":12900,"shippingSen":1000,"codFeeSen":0,"totalSen":13900,"currency":"MYR"},"tracking":{"courier":"","number":"","url":""},"utm":{"source":"facebook","medium":"paid","campaign":"launch","content":null,"term":null,"fbclid":null},"createdAt":"2026-08-22T04:10:00.000Z","updatedAt":"2026-08-22T04:10:00.000Z"}},{"schemaVersion":1,"event":"order.updated","eventId":"evt_update_01","occurredAt":"2026-08-22T06:00:00.000Z","test":false,"order":{"code":"AH-ABC123-1001","status":"shipped","paymentStatus":"cod","fulfillmentStatus":"shipped","paymentMethod":"cod","customer":{"name":"Nur Aisyah","phone":"60123456789","email":"aisyah@example.com","address1":"12 Jalan Melur","address2":"Taman Indah","postcode":"40000","city":"Shah Alam","state":"Selangor","customFields":{}},"package":{"slug":"pakej-kombo","name":"Pakej Kombo","sku":"CHECKOUT-KOMBO","quantity":1,"variant":null,"bundleItems":[]},"orderBumps":[],"orderBump":null,"amount":{"subtotalSen":12900,"shippingSen":1000,"codFeeSen":0,"totalSen":13900,"currency":"MYR"},"tracking":{"courier":"Ninja Van","number":"NVMY123","url":"https://example.com/track/NVMY123"},"utm":{"source":"facebook","medium":"paid","campaign":"launch","content":null,"term":null,"fbclid":null},"createdAt":"2026-08-22T04:10:00.000Z","updatedAt":"2026-08-22T06:00:00.000Z"}},{"schemaVersion":1,"event":"order.payment_failed","eventId":"order.payment_failed:ord_02","occurredAt":"2026-08-22T05:15:00.000Z","test":false,"order":{"code":"AH-DEF456-1002","status":"failed","paymentStatus":"failed","fulfillmentStatus":"unfulfilled","paymentMethod":"fpx","customer":{"name":"Muhammad Ali","phone":"60198765432","email":"ali@example.com","address1":"8 Jalan Damai","address2":"","postcode":"75450","city":"Melaka","state":"Melaka","customFields":{}},"package":{"slug":"pakej-asas","name":"Pakej Asas","sku":"CHECKOUT-ASAS","quantity":1,"variant":null,"bundleItems":[]},"orderBumps":[],"orderBump":null,"amount":{"subtotalSen":7900,"shippingSen":800,"codFeeSen":0,"totalSen":8700,"currency":"MYR"},"tracking":{"courier":"","number":"","url":""},"utm":{"source":null,"medium":null,"campaign":null,"content":null,"term":null,"fbclid":null},"createdAt":"2026-08-22T04:15:00.000Z","updatedAt":"2026-08-22T05:15:00.000Z"}},{"schemaVersion":1,"event":"checkout.abandoned","eventId":"checkout.abandoned:cs_01","occurredAt":"2026-08-22T04:40:00.000Z","test":false,"checkout":{"customer":{"name":"Siti Hajar","phone":"60111222333","email":"","address1":"","address2":"","postcode":"","city":"","state":"","customFields":{}},"package":{"slug":"pakej-kombo","name":"Pakej Kombo","sku":"CHECKOUT-KOMBO","variantSelections":{},"bundleSelections":{"sku_01":2},"bundleSlotSelections":{}},"paymentMethod":"cod","source":{"landingPage":{"id":"lp_01","slug":"promo-ogos","title":"Promo Ogos"},"sessionId":"sid_01","utm":{"source":"facebook","medium":"paid","campaign":"launch","content":null,"term":null,"fbclid":null}},"createdAt":"2026-08-22T04:00:00.000Z","lastActivityAt":"2026-08-22T04:10:00.000Z","resumeUrl":"https://shop.example.com/checkout/pakej-kombo?rt=resume_token"}}]}