Charity Service

The SurePay IBAN-Name Check provides a standard lookup service for the ‘gironummers’ of Charities in The Netherlands. For example, for "giro 555", SurePay will provide the corresponding IBAN and name of the charity to the bank, so the user can complete an easy money transfer to the charity. The name of the charity is not mandatory in this request, but the account accountId.type = SHORTENED_ACCOUNT should be used. In this case, SurePay will return the name and the IBAN of the charity, so the bank can use this for the transfer. This add-on service may be used by IBAN-Name Check customers at no additional cost. For more information about the Charity Service, please contact info@surepay.nl.

To gain access to SurePay's add-ons, customers are required to notify service@surepay.nl first. This notification is essential to enable access to these additional features.

Request

To receive the IBAN related to the Charity Service, the request should contain a SHORTENED_ACCOUNT

  • accountIdobjectMandatory

    Object used to send the account information in the request.

    • valuestring
      • SHORTENED_ACCOUNT a valid shortened account like "Giro 555".
    • typeenum

      For a succesful PayID check, this enum needs to be either EMAIL or PHONE.

  • namestring

    Name of the account holder. Optional when using SHORTENED_ACCOUNT.

    • Max. 70 characters.

Response

In the response the corresponding IBAN will be passed back.

  • resultobjectAlways returned
    • accountobjectAlways returned

      Object holding the bank account details.

      • ibanstring

        Contains the IBAN of the shortened account.

        • Format: [A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}

Request

    {
        "accountId": {
            "value": "555",
            "type": "SHORTENED_ACCOUNT"
        },
        "name": "Giro 555"
    }

Response

    {
        "result": {
            "account": {
                "accountHolderType": "ORG",
                "iban": "NL08INGB0000000555",
                "status": "ACTIVE"
            },
            "resultType": "MATCHING"
        }
    }
Previous
Next