ramp.compliance_screen
Compliance pre-screen for Ramp accounting agent payments — run before issuing an Agent Card to eliminate unnecessary human approval queues. Performs 5 checks in parallel: (1) FATF country risk on source and destination country, (2) amount threshold flags (CTR-equivalent at $10K, large-payment at $100K), (3) OpenSanctions global sanctions screen by counterparty name, (4) OpenSanctions PEP screen for individual counterparties or payroll, (5) GLEIF UBO chain with sanctions at each beneficial ownership node (if LEI provided). Returns APPROVED / FLAGGED / BLOCKED with a humanRequired boolean — true only for FLAGGED cases. APPROVED: issue card automatically, no human needed. BLOCKED: halt, do not proceed, do not notify counterparty. FLAGGED: route to compliance queue. Removes human-in-the-loop for the ~95% of payments that are clean.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Payment amount in units of currency. | |
| currency | No | ISO 4217 currency code. Defaults to "USD". | |
| paymentType | No | Payment type — payroll automatically triggers PEP screen. | |
| isIndividual | No | true if counterparty is an individual (triggers PEP screen). Defaults to false. | |
| sourceCountry | No | ISO 3166-1 alpha-2 source country. Defaults to "US". | |
| counterpartyLei | No | Optional GLEIF LEI — enables UBO chain check and satisfies FATF R.16 originator identification. | |
| counterpartyName | Yes | Legal name of the payment counterparty. | |
| counterpartyCountry | No | ISO 3166-1 alpha-2 destination country (e.g. "DE", "NG", "IR"). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| checks | No | fatfCountry, amountFlags, sanctions, pep, uboChain check details. | |
| _action | No | Recommended action for the agent. | |
| fatfR16 | No | FATF R.16 satisfied status and basis. | |
| reasons | No | Specific reasons for the decision. | |
| decision | No | Compliance decision. | |
| riskScore | No | Risk score 0–100. | |
| humanRequired | No | true only for FLAGGED — APPROVED payments proceed automatically. |