Bank List

Returns the banks supported by the active gateway, with the VA types each supports.

Endpoint

GET /api/v1/va/bank-list

Authentication

Use X-API-KEY.

Header	Value	Required
X-API-KEY	your API key	M

Response fields

Field	Type	Description
bank_code	string	Bank code used in create transaction.
bank_name	string	Display name.
va_type	string[]	Supported VA types, usually DYNAMIC and STATIC.

Example

Response 200 OK

{
	"success": true,
	"message": "Bank list retrieved successfully",
	"data": [
		{ "bank_code": "BMRI", "bank_name": "Bank Mandiri", "va_type": ["DYNAMIC", "STATIC"] },
		{ "bank_code": "BNIA", "bank_name": "Bank CIMB Niaga", "va_type": ["DYNAMIC", "STATIC"] },
		{ "bank_code": "BBBA", "bank_name": "Bank Permata", "va_type": ["DYNAMIC", "STATIC"] },
		{
			"bank_code": "BRIN",
			"bank_name": "Bank Rakyat Indonesia (BRI)",
			"va_type": ["DYNAMIC", "STATIC"]
		},
		{
			"bank_code": "BSYI",
			"bank_name": "Bank Syariah Indonesia (BSI)",
			"va_type": ["DYNAMIC", "STATIC"]
		}
	],
	"timestamp": "2026-06-23T14:22:39+07:00"
}

Response 401 Unauthorized

{
	"success": false,
	"message": "invalid api key",
	"error": {
		"code": "UNAUTHORIZED"
	},
	"timestamp": "2026-06-23T14:33:05+07:00"
}

Supported banks

• BMRI - Bank Mandiri
• BNIA - Bank CIMB Niaga
• BBBA - Bank Permata
• BRIN - Bank Rakyat Indonesia (BRI)
• BSYI - Bank Syariah Indonesia (BSI)

Status codes

Code	Meaning
200	Bank list retrieved.
401	Missing or invalid API key.