api.fincodesapi.com
Validate IBANs, BIC/SWIFT codes and local bank routing codes worldwide with one REST API. ABA, BSB, IFSC, CLABE, NCC, Canadian routing numbers and more, plus payee verification and sanctions screening.
The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xcd0DDf5A922779279927c4CCfD443949C53908D4",
"amount": "200000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 60
}
],
"resource": {
"url": "https://api.fincodesapi.com/x402/iban/verify-payee",
"tags": [
"verification-of-payee",
"vop",
"iban",
"payments",
"banking"
],
"mimeType": "application/json",
"description": "Verify whether a payee name matches the account holder for a supported SEPA IBAN. Returns MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE or BANK_UNAVAILABLE together with IBAN and bank information enriched using maintained banking reference data. No account, API key or subscription required; x402 clients handle USDC payment automatically. Requests missing the iban or payee_name field are rejected with HTTP 400 before payment. Price: $0.20 USDC per request.",
"serviceName": "Fin Codes API"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"iban": "DE75512108001245126199",
"payee_name": "John Doe",
"include_matched_payee_name": true
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"data": {
"id": "DE75512108001245126199",
"bic": {
"id": "SOGEDEFF",
"bank": {
"id": "cfb1758f-1195-4be9-b981-3fc63da7306b",
"code": "SOGE",
"name": "SOCIETE GENERALE S.A.",
"country_id": "DE"
},
"city": {
"id": "c3eb05ae-2709-45c7-9799-d5e2fee08946",
"name": "Frankfurt Am Main",
"country_id": "DE"
},
"address": "NEUE MAINZER STRASSE 46-50",
"country": {
"id": "DE",
"name": "Germany"
},
"postcode": "60311",
"branch_code": "",
"branch_name": "SOGEBANK Frankfurt Main"
},
"country": {
"id": "DE",
"name": "Germany"
},
"account_number": "1245126199",
"payee_name_match": "MATCH",
"national_bank_code": "51210800",
"national_branch_code": ""
},
"success": true
}
}
},
"schema": {
"type": "object",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"body",
"bodyType"
],
"properties": {
"body": {
"type": "object",
"required": [
"iban",
"payee_name"
],
"properties": {
"iban": {
"type": "string",
"example": "DE75512108001245126199",
"description": "SEPA IBAN whose account holder name should be verified."
},
"payee_name": {
"type": "string",
"example": "John Doe",
"description": "Expected payee/account-holder name to verify."
},
"include_matched_payee_name": {
"type": "boolean",
"default": false,
"example": true,
"description": "When true, return the matched payee name for CLOSE_MATCH results. Cached close matches are rechecked live."
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"const": "POST"
},
"bodyType": {
"type": "string",
"const": "json"
}
}
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"const": "json"
},
"example": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "DE75512108001245126199",
"description": "IBAN code"
},
"bic": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "SOGEDEFF",
"description": "BIC code"
},
"bank": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "cfb1758f-1195-4be9-b981-3fc63da7306b",
"description": "Bank ID"
},
"code": {
"type": "string",
"example": "SOGE",
"description": "4 letters bank code"
},
"name": {
"type": "string",
"example": "SOCIETE GENERALE S.A.",
"description": "Bank name"
},
"country_id": {
"type": "string",
"example": "DE",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"city": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "c3eb05ae-2709-45c7-9799-d5e2fee08946",
"description": "City ID"
},
"name": {
"type": "string",
"example": "Frankfurt Am Main",
"description": "City name"
},
"country_id": {
"type": "string",
"example": "DE",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"address": {
"type": "string",
"example": "NEUE MAINZER STRASSE 46-50",
"description": "Address"
},
"country": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "DE",
"description": "ISO 3166-1 alpha-2 country code"
},
"name": {
"type": "string",
"example": "Germany",
"description": "Country name"
}
}
},
"postcode": {
"type": "string",
"example": "60311",
"description": "Postcode"
},
"branch_code": {
"type": "string",
"example": "",
"description": "Branch code"
},
"branch_name": {
"type": "string",
"example": "SOGEBANK Frankfurt Main",
"description": "Branch name"
}
}
},
"country": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "DE",
"description": "ISO 3166-1 alpha-2 country code"
},
"name": {
"type": "string",
"example": "Germany",
"description": "Country name"
}
}
},
"account_number": {
"type": "string",
"example": "1245126199",
"description": "Account number"
},
"payee_name_match": {
"enum": [
"MATCH",
"CLOSE_MATCH",
"NO_MATCH",
"NOT_APPLICABLE",
"BANK_UNAVAILABLE",
null
],
"type": [
"string",
"null"
],
"example": "MATCH",
"description": "Payee name match result"
},
"matched_payee_name": {
"type": [
"string",
"null"
],
"description": "Matched payee name returned for a live close match when explicitly requested"
},
"national_bank_code": {
"type": "string",
"example": "51210800",
"description": "National bank code"
},
"national_branch_code": {
"type": "string",
"example": "",
"description": "National branch code"
}
}
},
"success": {
"type": "boolean",
"example": true,
"description": "Success"
}
}
}
}
}
}
}
}
},
"x402Version": 2
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
Pay 0.2 USDC on Base to 0xcd0D…908D4. The signed payment is good for 1 minute.
- Paid to
- 0xcd0D…908D4
- USD Coin contract
- 0x8335…02913
- Payment window
- 1 minute
- As published
- 200000 smallest units
- Returns
- application/json
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xcd0DDf5A922779279927c4CCfD443949C53908D4",
"scheme": "exact",
"network": "eip155:8453",
"mimeType": "application/json",
"resource": "https://api.fincodesapi.com/x402/iban/verify-payee",
"description": "",
"maxAmountRequired": "200000",
"maxTimeoutSeconds": 60
}
]Provenance
- Seen in the source catalog
- 2026-09-30 06:19Z
- Last indexed by Roundhouse
- 2026-10-21 17:46Z
- Last enriched (probe, favicon, geo)
- 2026-10-01 04:15Z
- x402 version
- 1
- Max timeout
- 60s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
No per-endpoint history for this service yet, so this is payments indexed to its PROVIDER's wallet over 30 days. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service api.fincodesapi.com and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=api.fincodesapi.com' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://api.fincodesapi.com/x402/iban/verify-payee, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Either pay over x402 (mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402), or ask me for an organization key, which I create at https://roundhouseai.io/dashboard/connections. If you have neither, ask before going further. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.