1. Direct API
Merchant Warrior API 2.0
  • API
    • Getting Started
    • Guides
      • Xero Connection
      • Xero Custom URL
      • wooCommerce PayID
      • Middleware
      • Hostaway
    • Direct API
      • getAccessToken
        POST
      • processCard
        POST
      • processAuth
        POST
      • processCapture
        POST
      • processBatch
        POST
      • retrieveBatch (CSV)
        POST
      • retrieveBatch (JSON Response)
        GET
      • retrieveBatch (JSON Notify)
        GET
      • refundCard
        POST
      • queryCard
        POST
      • processDDebit
        POST
      • processDDebitAuth
        POST
      • processVoid
        POST
      • verifyCard
        POST
      • queryDD
        POST
      • queryBIN
        POST
      • getSettlement
        POST
      • checkEnrollment
        POST
      • checkPARes
        POST
      • addBlacklistedCard
        POST
      • removeBlacklistedCard
        POST
      • queryBlacklistedCard
        POST
      • simulateNotify
        POST
      • getSurcharge
        POST
    • 3DS 2.0
      • Introduction
      • 3DS 2 Authentication Flows
      • Step 3 - 3DS Method Data
      • Step 5 - Challenge
      • Step 1 - getAccessToken
      • Step 2 - checkEnrollment
      • Step 4 - checkTDSAuth
      • Step 6 - checkPARes
      • Step 7 - processCard
      • Authorization Only processCard
    • PayLink
      • Introduction
      • Generate PayLink
    • PayID
      • Introduction
      • Create
      • Transaction
      • Get
      • Update
      • Status
      • List
      • Refund
    • PayTo
      • Introduction
      • Simulator
      • Certification
      • Actions and Statuses
      • Agreements
        • Agreements
        • Notifications
        • Create Agreement
        • Get Agreement
        • Amend Agreement
        • Amend Agreement Status
        • Recall Agreement Action
      • Payments
        • Payments
        • Notifications
        • Create Payment
        • Get Payment
        • Get Payment Status
        • Search Payments
    • Confirmation of Payee
      • Introduction
      • Sandbox Simulations
      • Validate
    • POS
      • Introduction
      • processPOS
      • refundPOS
      • voidPOS
      • deregisterPOS
    • Web SDK
      • Introduction
      • Usage
      • getAccessToken
      • Options
      • Initiate
      • Payframe Functionality
      • Middleware
      • addCard
    • Payframe
      • Introduction
      • Usage
      • Constructor
      • tdsCheck
      • Additional Functions
      • Styling
      • processCard
      • processAuth
    • Digital Wallets
      • Apple Pay Prerequisites
      • Google Pay Prerequisites
      • Web SDK
      • Manual Integration
      • processCard
      • addCard
      • getMerchantSession
      • decryptApplePayToken
    • Token Payments
      • Introduction
      • Key Management
      • addCard
      • removeCard
      • cardInfo
      • changeExpiry
      • processCard
      • processAuth
    • Batch
      • Introduction
      • Card Batches
      • Token Batches
      • Direct Debit Batches
    • Forter
      • Introduction
      • Testing
    • Payouts
      • Introduction
      • Sandbox Simulations
      • Notifications
      • Create Payouts
      • Get Payout Status
      • Resend Notifications
      • Get Payout Transaction Status
      • Get Payout Transaction Notify
    • Partner API
      • Introduction
      • addMerchant
      • updateMerchant
      • checkMerchant
    • Notifications
      • Notifications
  • Hosted Payment Page
    • processCard
  1. Direct API

queryBIN

Sandbox
https://base.merchantwarrior.com
Sandbox
https://base.merchantwarrior.com
POST
/post
The queryBIN method is used to determine the banking information (Bank Name, Card Type, Card Country etc) related to a credit/debit card's Bank Identification Number (BIN).
This is a paid addon. Please contact Merchant Warrior for pricing and access.
The sandbox environment will always return testing BIN information. Accurate BIN information is available in the production environment.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
OK
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://base.merchantwarrior.com/post' \
--header 'MW-API-VERSION: 2.0' \
--header 'Content-Type: application/json' \
--data '{
    "method": "queryBIN",
    "merchantUUID": "123456789abcd",
    "apiKey": "1a3b5c",
    "binHash": "e9ddc296b76b3398934bfc06239073df",
    "bin": "512346",
    "paymentCardNumber": "4564710000000004",
    "cardID": "NUFM56937091",
    "digitalWalletToken": "{\"data\":\"Ti5Lz0qwJ+V6YoAv1iLr8GiS3C5TkRY7LZpAZZVkDpKAwdKM0FLHeUH7aD 5ePJShB04uiDVUeO0h0+kU3S5xAwlpHD5N2f4aCwXCJ0jUn4g9EGViDOwG5MyeJrQ8blBEG+qXybQ+G V67RP2tA9WFGrACQyt9dyOXUb4obX6p6VJJUzbXhMO0EYobu2eWWmq395h9vKjt1RdznoA4RUzRy+d fI/NBwO8ROW7+icoDmKJIQ0s37F22HOOed <large amount of data trimmed for sample>\"},\"version\":\"EC_v1\"}"
}'
Response Response Example
{
    "rate": [],
    "recurring_rate": [],
    "responseMessage": "Operation successful",
    "bin": "456442",
    "brand": "VISA",
    "name": "CLASSIC",
    "responseCode": "0",
    "bank_name": "COMMONWEALTH BANK OF AUSTRALIA",
    "country": "AU",
    "type": "CREDIT"
}
Modified at 2026-08-07 06:28:26
Previous
queryDD
Next
getSettlement
Built with