Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt

Use this file to discover all available pages before exploring further.

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.
ScenarioA developer at Clearpath Payments wants to understand which sponsor banks are available and which BINs are associated with each bank. This information will help them select the appropriate sponsor bank when creating the Maple Street Coffee acceptor application.
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"
          }
        ]
      }
    ]
  }
}
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.