BIN Checker API

Endpoint API to identify any card's brand, type, issuing bank, and country straight from the BIN — returned as clean, typed JSON over one simple REST endpoint.

JSON Attributes

Name	Data Type	Required	Details
bin_number	String (8)	Yes	must be number

Information

Hostname	https://api-stage.mcpayment.id
Path	/bin-list/api/inquiry/merchant
HTTP Method	POST

Headers

Key	Format	Required	Value
Content-Type	application/json	M
merchant-id	String	M	Your Unique ID String - Merchant ID
client-credential	String	M	Client credential

Example

Body raw

{
    "bin_number" : "557338"
}

Example Request

curl

curl --location 'https://https://api-stage.mcpayment.id/bin-list/api/inquiry/merchant' \
--header 'merchant-id: MCP00001234' \
--header 'client-credential: i/JHaz/23efWGHSA45hgTDo2VkthRnJ0MllVVnIvWVJ1YWh5L3JGTG8vako1OXhOTFpqblpHQzVHbGRnPQ==' \
--header 'Content-Type: application/json' \
--data '{
    "bin_number" : "557338"
}'

go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://https://api-stage.mcpayment.id/bin-list/api/inquiry/merchant"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
    "bin_number" : "557338"`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("merchant-id", "MCP00001234")
  req.Header.Add("client-credential", "i/JHaz/23efWGHSA45hgTDo2VkthRnJ0MllVVnIvWVJ1YWh5L3JGTG8vako1OXhOTFpqblpHQzVHbGRnPQ==")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

js

const axios = require('axios');
let data = JSON.stringify({
  "bin_number": "557338"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://https://api-stage.mcpayment.id/bin-list/api/inquiry/merchan',
  headers: { 
    'merchant-id': 'MCP00001234', 
    'client-credential': 'i/JHaz/23efWGHSA45hgTDo2VkthRnJ0MllVVnIvWVJ1YWh5L3JGTG8vako1OXhOTFpqblpHQzVHbGRnPQ==', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

php

<?php
$client = new Client();
$headers = [
  'merchant-id' => 'MCP00001234',
  'client-credential' => 'i/JHaz/23efWGHSA45hgTDo2VkthRnJ0MllVVnIvWVJ1YWh5L3JGTG8vako1OXhOTFpqblpHQzVHbGRnPQ==',
  'Content-Type' => 'application/json'
];
$body = '{
  "bin_number": "557338"
}';
$request = new Request('POST', 'https://https://api-stage.mcpayment.id/bin-list/api/inquiry/merchan', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

Example Response

{
    "country": "ID",
    "currency": "IDR",
    "bank_name": "PT. BANK MANDIRI (PERSERO) TBK.",
    "bin_number": "557338",
    "bin_type": "First 6",
    "card_type": "CREDIT",
    "status": "ACTIVE",
    "acquirer": "MASTERCARD"
}