---
description: Let your systems know when your digital entity balance has changed
---

# \[optional] Callbacks

{% hint style="success" %}
There are 3 types of callbacks:

1. `pay-in` -  sent to bank-recipient
2. `pay-out` - sent to bank-sender
3. `transfer`- sent to the recipient (and it is a sender as well)&#x20;
{% endhint %}

The call-back process is shown on the diagram:

<figure><img src="https://3204608041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtSAbV2p2auxzoLyMptKl%2Fuploads%2FecoOd4YvIVlv5K4roFlL%2Fimage.png?alt=media&#x26;token=56169999-a666-444f-9113-06dfdbb93057" alt=""><figcaption></figcaption></figure>

### POST /pay-in

#### Request example

```json
curl -location https://{host_bank_receiver}/api/dcm/notify/pay-in
--data '{
    "transaction_id": "d3626591-7e01-4346-9f53-ddea6d7d17bd"
}'
```

{% hint style="info" %}
Full data about the transfer you can check via [#get-payment](..#get-payment "mention").
{% endhint %}

#### Response example

```json
200 OK
```

### POST /pay-out

#### Request example

```json
curl -location https://{host_bank_sender}/api/dcm/notify/pay-out
--data '{
    "transaction_id": "d3626591-7e01-4346-9f53-ddea6d7d17bd"
}'
```

{% hint style="info" %}
Full data about payment you can check via [#get-payment](..#get-payment "mention").
{% endhint %}

#### Response example

```json
200 OK
```

### POST /transfer

#### Request example

```json
curl -location https://{host_bank_sender/receiver}/api/dcm/notify/transfer
--data '{
    "transaction_id": "d3626591-7e01-4346-9f53-ddea6d7d17bd"
}'
```

{% hint style="info" %}
Full data about payment you can check via [#get-payment](..#get-payment "mention").
{% endhint %}

#### Response example

```json
200 OK
```
