Shield: rules, review and recalls

How Shield decides, how to tune it, and how to work the review queue and recall cases.

The decision pipeline

1. Attribute the credit to a virtual account by IBAN.
2. Name check the payer against the holder: exact, close (with a score), no_match or unavailable when the rail did not carry a name.
3. Screen the payer against sanctions, PEP and adverse-media lists.
4. Apply rules: account rules, programme rules, velocity and country controls.
5. Decide: accept, review or return.

Programme rules

{
  "first_party_only": true,
  "name_match": { "auto_accept_threshold": 0.92, "review_threshold": 0.70 },
  "screening": { "sanctions": true, "pep": true, "adverse_media": true },
  "limits": { "max_credit_amount": 5000000, "daily_per_payer": 20000000 },
  "payer_countries": { "mode": "allow", "list": ["EEA", "GB", "CH", "CA"] }
}

Account-level rules override programme rules where they are stricter. Turning off first_party_only requires approval from our compliance team and a documented justification.

Review queue

Credits in review appear in GET /reviews and in the console. Accept or return them with POST /credits/{id}/accept or POST /credits/{id}/return. Credits not actioned within 5 business days are returned automatically.

Recalls

When a bank requests a credit back, a recall case is opened and recall.opened fires with a respond_by date. Submit evidence with POST /recalls/{id}/evidence: invoices, contracts, delivery proof or correspondence as base64 attachments with a short description. Our recall team responds to the bank and the case closes with recall.closed and an outcome of retained or returned.

curl https://api.neofin.tech/v1/recalls/rc_3Fm7Qa/evidence \
  -H "Authorization: Bearer $NEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "description": "Signed delivery note for INV-2291", "file": { "name": "delivery-2291.pdf", "content_type": "application/pdf", "data": "JVBERi0xLjQK..." } }'

Partner reporting pack

Institutional clients receive a monthly pack with volumes, return rate, recall ratio and corridor breakdown, signed off by our MLRO. It is available in the console under Reports on the fifth business day of each month.