Skip to main content
Sponsor banks are the financial institutions that facilitate payment processing for your acceptor. When creating an acceptor application, you may need to query available sponsor banks and their associated Bank Identification Numbers (BINs) to select the appropriate sponsor bank for your application.
Sponsor banks represent the financial institutions that will back your payment processing. Each sponsor bank may have multiple BINs (Bank Identification Numbers) that identify the issuing bank for card transactions. Understanding available sponsor banks helps you make informed decisions when configuring your acceptor application.
ScenarioBen wants to understand which sponsor banks are available for his mechanical keyboard business and which BINs are associated with each bank. This information will help him select the appropriate sponsor bank when creating his acceptor application.

​
Query available sponsor banks

Use the sponsorBanks query to retrieve a list of available sponsor banks and their associated BINs. The query accepts an optional input parameter to filter results. 
query SponsorBanks {
  sponsorBanks {
    sponsorBankId
    name
    bins {
      descriptor
      id
    }
  }
}

{
  "data": {
    "sponsorBanks": [
      {
        "sponsorBankId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Acme Financial Group",
        "bins": [
          {
            "descriptor": "Acme Visa Credit",
            "id": "c7d8e9f0-a1b2-4c3d-8e5f-6a7b8c9d0e1f"
          },
          {
            "descriptor": "Acme Mastercard Debit",
            "id": "d8e9f0a1-b2c3-4d5e-9f6a-7b8c9d0e1f2a"
          }
        ]
      },
      {
        "sponsorBankId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "Pinnacle Banking Corporation",
        "bins": [
          {
            "descriptor": "Pinnacle Visa Debit",
            "id": "e9f0a1b2-c3d4-4e5f-a6b7-8c9d0e1f2a3b"
          },
          {
            "descriptor": "Pinnacle Mastercard Credit",
            "id": "f0a1b2c3-d4e5-4f6a-b7c8-9d0e1f2a3b4c"
          }
        ]
      }
    ]
  }
}
Run in Playground
The sponsor bank information returned by this query includes the bank’s unique identifier ( sponsorBankId ), name, and an array of BINs with their descriptors. This information can be used when configuring your acceptor application to ensure compatibility with your payment processing requirements.