{"uid":"cap_OmmvgopWc38c4Sm0uopdJ","slug":"iso-11649-rf-creditor-reference-validator-generator-d4d4dbfd","name":"ISO 11649 RF Creditor Reference Validator & Generator","description":"ISO 11649 RF creditor reference (SEPA structured reference) — validate or generate. ?ref=RF18539007547034 checks the ISO 7064 mod 97-10 checksum and format (RF + 2 check digits + up to 21 alphanumerics); ?generate=539007547034 computes the check digits and returns the full RF reference with print formatting. Complements iban-check and vat-check for SEPA invoicing agents. Purely local, instant.","url":"https://402utils.com/v1/rf-reference","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"ref":{"type":"string","description":"An RF reference to validate, e.g. RF18539007547034 (spaces tolerated)."},"attest":{"type":"string","description":"Set to 1 for an Ed25519-signed attestation of the result (audit trail)."},"generate":{"type":"string","description":"A raw reference (1-21 chars, A-Z/0-9) to wrap into an RF reference."}},"description":"Exactly one of `ref` (validate) or `generate` (create)."}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["mode","valid","ref","reference","checkDigits","formatted"],"properties":{"ref":{"type":"string","description":"Normalized full RF reference."},"mode":{"type":"string","description":"'validate' or 'generate'."},"valid":{"type":"boolean"},"formatted":{"type":"string","description":"Groups of 4 (presentation format)."},"reference":{"type":"string","description":"The bare creditor reference inside."},"attestation":{"type":"object","properties":{"alg":{"type":"string","const":"Ed25519"},"sig":{"type":"string","description":"base64url Ed25519 signature over the canonical JSON of payload."},"payload":{"type":"object","properties":{"ts":{"type":"string","format":"date-time"},"kid":{"type":"string","description":"Key id — matches a key in the .well-known document."},"endpoint":{"type":"string"},"resultSha256":{"type":"string","description":"SHA-256 of the canonical JSON of the result (attestation excluded)."}}}},"description":"Present only with ?attest=1. Ed25519 signature over the canonical result; verify against /.well-known/402utils-attestation.json."},"checkDigits":{"type":"string"},"formatValid":{"type":"boolean","description":"Validate mode: RF + 2 digits + 1-21 alphanumerics."},"checksumValid":{"type":"boolean","description":"Validate mode: ISO 7064 mod 97-10 result."}}}}}}},"responseSchema":{"type":"json","example":{"ref":"RF18539007547034","mode":"validate","valid":true,"formatted":"RF18 5390 0754 7034","reference":"539007547034","checkDigits":"18","formatValid":true,"checksumValid":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UpJSVxba6Ng1HhhY3Mt_9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an existing ISO 11649 RF creditor reference (SEPA structured reference) or generates a new one from a raw reference string, using ISO 7064 mod 97-10 checksum logic.","exampleAgentPrompt":"Can you validate the RF creditor reference RF18539007547034 for me — check the checksum and format, and give me the print-formatted version with grouped digits?","exampleUseCases":null,"resultDescription":"Returns a JSON object with mode ('validate' or 'generate'), the normalized full RF reference, a validity boolean, the extracted bare creditor reference, the two check digits, a grouped print-formatted version (blocks of 4), and optionally an Ed25519-signed attestation payload for audit trails.","failureModes":["Missing both ref and generate parameters — returns error indicating exactly one is required","Invalid characters in ref or generate input (non-alphanumeric) — returns format error","RF reference with wrong checksum — returns valid:false with details","Raw reference longer than 21 characters — returns length validation error","Malformed RF prefix (not starting with RF) — returns format error"],"whenToPreferThis":"Use this endpoint when you need to validate or generate ISO 11649 RF creditor references (SEPA structured references) as part of invoice processing, payment automation, or financial compliance workflows. Prefer it over general IBAN or VAT validators when the specific task involves RF creditor reference check digits. The optional Ed25519 attestation makes it suitable for audit-trail requirements.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:52:29.098Z","isFirstParty":false}