---
title: "Maya payment callback"
method: POST
path: "/v1/paymaya/webhook"
tags: ["PayMaya"]
---

# Maya payment callback

`POST /v1/paymaya/webhook`

## Request

- Base URL: `https://ewallets-api.paymongo.com`
- URL: `https://ewallets-api.paymongo.com/v1/paymaya/webhook`
- Auth: none required

Public. For an attachment this service holds (looked up by Maya's payment id), the callback is queued as a hint and the real outcome is read from Maya; answers {"message":"OK"}. A callback for any other payment is forwarded unchanged to core-api's private host and core-api's status and body are relayed. A callback for our attachment from an address outside the configured allowlist is refused.

## Request body

- MayaCallbackBody
  - `errorCode` string
  - `id` string
  - `receiptNumber` string
  - `requestReferenceNumber` string
  - `status` string

## Response `200`

{\"message\":\"OK\"} when queued; otherwise core-api's answer, status and body as is

- object

## Other responses

- `403`: unauthorized: ours, but not from an allowed address
- `413`: invalid_request_body: body over 64 KiB
- `500`: internal_server_error: not queued; Maya retries
- `502`: service_unavailable: core-api did not answer
- `503`: service_unavailable: not ours and no core-api host is configured

---

[API](https://skmtc.dev/paymongo/apis/ewallets.md) - [All operations](https://skmtc.dev/paymongo/apis/ewallets/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/ewallets/revisions/a445ca65c132?raw)