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

  • Name
    accountId
    Type
    object
    Tag(s)
    Mandatory
    Description

    Object used to send the account information in the request.

    • Name
      value
      Type
      string
      Tag(s)
      Description
      • SHORTENED_ACCOUNT a valid shortened account like "Giro 555".
    • Name
      type
      Type
      enum
      Tag(s)
      Description

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

  • Name
    name
    Type
    string
    Tag(s)
    Description

    Name of the account holder. Optional when using SHORTENED_ACCOUNT.

    • Max. 70 characters.

Response

In the response the corresponding IBAN will be passed back.

  • Name
    result
    Type
    object
    Tag(s)
    Always returned
    Description
    • Name
      account
      Type
      object
      Tag(s)
      Always returned
      Description

      Object holding the bank account details.

      • Name
        iban
        Type
        string
        Tag(s)
        Description

        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