---
title: "Merchant acknowledges payment status callback was received"
method: POST
path: "/v3/payments/{id}/acknowledge"
tags: ["Merchant Acknowledge"]
---

# Merchant acknowledges payment status callback was received

`POST /v3/payments/{id}/acknowledge`

## Path parameters

- `id` string, required

## Request body

- MerchantAcknowledge
  - `currency` 'EUR', required — Currency code. Only EUR is supported [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217)
  - `amount` integer, required — Amount in cents requested
  - `reference` string — Merchant payment reference, used to reference the Bancontact Company payment in the merchant’s system. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best).

## Response `202`

The acknowledge request for the specified payment has been processed

## Other responses

- `400` — **Error Codes** * `FIELD_IS_REQUIRED`: Field X is mandatory * `FIELD_IS_INVALID`: Field X is invalid
- `401` — **Error Codes** * `UNAUTHORIZED`: caller doesn’t have an api-key access token
- `403` — **Error Codes** * `ACCESS_DENIED`: The JWT could not be verified or doesn’t contain the required authority to access the resource requested
- `404` — **Error Codes** * `PAYMENT_NOT_FOUND`: no payment could be found for the supplied identifier
- `422` — **Error Codes** * `PAYMENT_VOIDED`: Payment is already voided
- `500` — **Error Codes** * `TECHNICAL_ERROR`: Technical error in Payment service
- `503` — **Error Codes** * `SERVICE_UNAVAILABLE`: Payment service could not be reached or some unexpected error occurred

---

[API](https://skmtc.net/bancontactpro/apis/payment-v3-api.md) · [All operations](https://skmtc.net/bancontactpro/apis/payment-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bancontactpro/payment-v3-api/versions/4093d799b771/schema)