# Transfer Notification API
source: https://developer.mastercard.com/mastercard-send-disbursements/documentation/api-reference/transfer-notification/index.md

Note: We have hidden this page from the main documentation set because we are no longer promoting this API.

Unless you are already using this API, please do **not** start coding for it.

This resource is an **outbound** service that will post notifications to your webhook URL about particular non-card (FPS) payment activity:

* Inbound payment transfers
* A reversal on an inbound payment transfer
* A return on a push payment

Your webhook must be registered in the Mastercard Send Customer Site by the Mastercard Customer Implementation Service (CIS) team.

## API {#api}


API Specification: `https://static.developer.mastercard.com/content/mastercard-send-disbursements/swagger/TransferNotification_Swagger.yaml`

## Testing {#testing}

To receive a test notification message, initiate a Disbursement API request with a payload containing one of the following values for `recipient_account_uri`. Specify the value using the 'iban' schema, for example `iban:GB49STLG60161311111111`.

| Recipient Account URI  |                                                 Simulated Inbound Payment Response                                                 |
|------------------------|------------------------------------------------------------------------------------------------------------------------------------|
| GB49STLG60161311111111 | Both Sender Account URI and Receiver Account URI contain Sort Code and Account Number.                                             |
| GB25STLG60161311112222 | Sender Account URI contains Sort Code and Account Number and Receiver Account URI contains Account Number and BIC.                 |
| GB98STLG60161311113333 | Sender Account URI contains Sort Code and Account Number and Receiver Account URI contains BIC and IBAN.                           |
| GB27STLG60161322221111 | Sender Account URI contains Account Number and BIC and Receiver Account URI contains Sort Code and Account Number.                 |
| GB03STLG60161322222222 | Both Sender Account URI and Receiver Account URI contain Sort Code and Account Number.                                             |
| GB76STLG60161322223333 | Sender Account URI contains Account Number and BIC and Receiver Account URI contains BIC and IBAN.                                 |
| GB05STLG60161333331111 | Sender Account URI contains BIC and IBAN and Receiver Account URI contains Sort Code and Account Number.                           |
| GB78STLG60161333332222 | Sender Account URI contains BIC and IBAN and Receiver Account URI contains Account Number and BIC.                                 |
| GB54STLG60161333333333 | Both Sender Account URI and Receiver Account URI contain BIN and IBAN.                                                             |
| GB13STLG60161366666666 | Inbound Reversal Scenario, will generate an Inbound Reversal Notification about 10 seconds after the Inbound Notification Response |

## Sample Notification Message {#sample-notification-message}

* JSON
* XML

```JSON
{
  "transfer_notification": {
    "transfers": {
      "item_count": 1,
      "resource_type": "list",
      "data": {
        "transfer": [
          {
            "sender": {
              "name_on_account": "Bobby Source"
            },
            "recipient": {
              "name_on_account": "Mr Recipient"
            },
            "transfer_notification_type":"INBOUND",
            "created": "2021-04-16T13:28:15-05:00",
            "status": "APPROVED",
            "id": "fps_yCgJ5dksHSHfZD-jJcjqaFwSmUN5",
            "resource_type": "transfer",
            "transfer_reference": "ref_D9O31N4BdlbiGLndUBITo1N7aNFX",
            "payment_type": "P2P",
            "sender_account_uri": "GB00XXXX20300200004588",
            "recipient_account_uri": "GB00SRLG20300200004588",
            "transfer_amount": {
              "value": "17508",
              "currency": "GBP"
            },
            "transaction_history": {
              "data": {
                "transaction": [
                  {
                    "network": "FPS_INBOUND",
                    "type": "PAYMENT",
                    "id": "trn_2JCJx0YGRz_hbHEmIlruHfJ6r822",
                    "resource_type": "transaction",
                    "account_uri": "GB00SRLG20300200004588",
                    "transaction_amount": {
                      "value": "17508",
                      "currency": "GBP"
                    },
                    "network_status_code": "00",
                    "network_status_description": "APPROVED",
                    "funds_availability": "IMMEDIATE",
                    "create_timestamp": "2021-04-16T13:28:15-05:00",
                    "status": "APPROVED",
                    "status_reason": "APPROVED",
                    "status_timestamp": "2021-04-16T13:28:15-05:00",
                    "transfer_notification_type":"INBOUND"
                  }
                ]
              },
              "resource_type": "list",
              "item_count": 1
            },
            "statement_descriptor": "040023;47078543",
            "original_status": "APPROVED",
            "status_timestamp": "2021-04-16T13:28:15-05:00",
            "payment_origination_country": "GBR",
            "transfer_priority": "FDP",
            "faster_payments_id": "sdmNaUtAInQ969q1vRKFjZrWjYQKz4",
            "payment_uid": "744151a3-dee4-e3af-c155-b43d35cc840d",
            "sender_bic": "SRLGGB2L",
            "recipient_bic": "SRLGGB2L",
            "non_card_token": "non-card-token:020nW7B3JYoHWphpF0kGvdk5r7a0ca_uYOOnYi7rfE-kh_fzhs8OaB2gA"
          }
        ]
      }
    }
  }
}
```

```XML
<transfer_notification>
  <transfers>
    <resource_type>list</resource_type>
    <item_count>1</item_count>
    <data>
      <transfer>
        <id>fps_9abcd233jk23l6c5lw5f</id>
        <resource_type>transfer</resource_type>
        <transfer_reference>DEF123456</transfer_reference>
        <payment_type>P2P</payment_type>
        <payment_origination_country>GBR</payment_origination_country>
        <sender_account_uri>iban:GB29NWBK60161331926819</sender_account_uri>
        <sender>
          <name_on_account>Jane Smith</name_on_account>
        </sender>
        <recipient_account_uri>iban:GB29NWBK60161331926819</recipient_account_uri>
        <recipient>
          <name_on_account>Jane Smith</name_on_account>
        </recipient>
        <transfer_notification_type>INBOUND</transfer_notification_type>
        <transfer_amount>
          <value>5300</value>
          <currency>USD</currency>
        </transfer_amount>
        <created>2021-04-16T13:28:15-05:00</created>
        <transaction_history>
          <resource_type>list</resource_type>
          <item_count>1</item_count>
          <data>
            <transaction>
              <id>trn_8h4me233jk23l6c5lw5f</id>
              <resource_type>transaction</resource_type>
              <account_uri>iban:GB29NWBK60161331926819</account_uri>
              <transaction_amount>
                <value>5300</value>
                <currency>GBP</currency>
              </transaction_amount>
              <network>FPS_INBOUND</network>
              <network_status_code>1234</network_status_code>
              <network_status_description>Beneficiary Sort Code/Account Number Unknown</network_status_description>
              <funds_availability>IMMEDIATE</funds_availability>
              <type>PAYMENT</type>
              <create_timestamp>2021-04-16T13:28:15-05:00</create_timestamp>
              <status>APPROVED</status>
              <status_reason>APPROVED</status_reason>
              <status_timestamp>2021-04-16T13:28:15-05:00</status_timestamp>
              <transfer_notification_type>INBOUND</transfer_notification_type>
            </transaction>
          </data>
        </transaction_history>
        <statement_descriptor>TST*THANKYOU</statement_descriptor>
        <original_status>APPROVED</original_status>
        <status>APPROVED</status>
        <status_timestamp>2021-04-16T13:28:15-05:00</status_timestamp>
        <transfer_priority>SIP</transfer_priority>
        <faster_payments_id>YE78126Q54WK2J06M33020170720826608371</faster_payments_id>
        <payment_uid>32e2f3f9-dee4-4d10-a470-3dfa01dbf118</payment_uid>
        <sender_bic>SRLGGB2L</sender_bic>
        <recipient_bic>SRLGGB2L</recipient_bic>
        <non_card_token>non-card-token:suZz18lhAFvx9LQa6U2VMxs0BJLAD_TXVzYvaqTsjcG_AImuzmvNXQ</non_card_token>
      </transfer>
    </data>
  </transfers>
</transfer_notification>
```