Get Supported Institutions

This endpoint retrieves the list of supported receiving banks or institutions for a specific provider and channel.

---

End Point

GET https://api.tylt.money/v2/prime-fiat/php/institutions/v2/list?provider={}&channel={}

Example Request

GEThttps://api.tylt.money/v2/prime-fiat/php/institutions/v2/list?provider=Pisomind&channel=pesonet

Request Headers

Headers

Name	Type	Example	Description
X-TLP-APIKEY	string	93ee3c5e133697251b5362bcf9cc8532476785t8768075616f58d88	Your Tylt API Key, used to identify your account in API requests.
X-TLP-SIGNATURE	string	d0afef3853dfc8489c8b9affa5825171fdd7y7685675e4966a05f66ed2b3eaf9462b3c9c0	HMAC SHA-256 signature generated using the API Secret Key to secure the request.

Query Parameters

Parameter	Required	Description
provider	Yes	The provider to fetch institutions from. Accepted values: Pisomind, Connecx.
channel	Yes	The payment rail or channel for the selected provider.

Notes

• Both provider and channel are mandatory.

• provider is case-insensitive.

• For Pisomind, only instapay and pesonet are valid channel values.

• For Connecx, pass the exact Connecx bank code identifier as the channel.

• The response format remains the same for both providers.

Code Snippet

Node JS

const axios = require('axios');
const crypto = require('crypto');

// Replace with your API Key and Secret
const apiKey = 'your-api-key';
const apiSecret = 'your-api-secret';

// Request params
const params = {
  provider: 'Pisomind',
  channel: 'pesonet'
};

// Create HMAC SHA-256 signature using the request params
const signature = crypto
  .createHmac('sha256', apiSecret)
  .update(JSON.stringify(params))
  .digest('hex');

// Define headers
const headers = {
  'x-api-key': apiKey,
  'X-TLP-SIGNATURE': signature,
  'Content-Type': 'application/json'
};

// Send the GET request
axios.get('https://api.tylt.money/v2/prime-fiat/php/institutions/v2/list', {
  headers,
  params
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error.response ? error.response.data : error.message);
  });

Response

200

{
  "msg": "Institutions retrieved",
  "data": {
    "institutions": [
      {
        "code": "CSPA001PH",
        "name": "PayMaya",
        "rail": "PHPCIS-1001"
      },
      {
        "code": "CSMK001PH",
        "name": "Maya Bank",
        "rail": "PHPCIS-1001"
      }
    ]
  }
}

400

Response Fields