generated: '2026-07-19'
method: searched
source: https://miniprogram.gcash.com/docs/miniprogram_gcash/mpdev/v1_pay
spec_type: Webhooks
docs:
- https://miniprogram.gcash.com/docs/miniprogram_gcash/mpdev/v1_pay
summary: >-
GCash Mini Program payments deliver asynchronous outcome notifications to a
merchant-registered callback URL. There is no published AsyncAPI document
(the streaming/event surface is partner-gated), so this captures the webhook
catalog only. No AsyncAPI spec is fabricated.
delivery:
registration: >-
Per-order via the paymentNotifyUrl field on /v1/payments/pay (max 1024
chars), or a portal-configured default notification URL.
transport: HTTP POST callback from GCash to the merchant endpoint
ack: merchant responds to confirm receipt (notifyPayment)
events:
- name: notifyPayment
trigger: payment order reaches a final state (success/failed) or requires reconciliation
operation: /v1/payments/notifyPayment
payload_fields: [result, paymentId, paymentRequestId, paymentAmount]
note: complements synchronous inquiryPayment polling to resolve U (unknown) results
- name: notifyRefund
trigger: refund order reaches a final state
related_operation: /v1/payments/inquiryRefund
note: refund outcome notification; refund is queried via inquiryRefund