Validate Payment Method
POST
Validate bank/payment-method details against payout rules without persisting
header
X-Api-Key<token>API key in format: sti_env_prefix_secret
application/json- body
network*stringPayout network — determines the payment method type to validate against (bank → BANK, swift → SWIFT)
Value in
"swift""bank""payid"destination*quote_id?stringAn active quote owned by this tenant, used to resolve route-specific requirements.
Match
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidDefault Response
application/json- response
valid*booleanWhether the payment method passes all validation rules
errors?array<>Present only when valid is false
curl -X POST 'https://api.sandbox.stables.money/api/v1/payment-methods/validate' \ -H 'Content-Type: application/json' \ -d '{ "network": "swift", "destination": { "type": "bank", "account_holder_name": "string", "bank_name": "string", "bank_country": "st", "currency": "str" }}'Example Response200
{ "valid": true, "errors": [ { "field": "string", "message": "string", "code": "UNSUPPORTED_CURRENCY" } ]}Check beneficiary bank details against the payout rules for a currency before you create a quote. Nothing is stored.