How to handle frozen accounts

Prime Trust may freeze customer accounts based on a variety of factors. Integrators can use webhooks to be notified of frozen customer accounts and act to unfreeze customer accounts.

Note: Webhook versions before November 1, 2021 only returned a freeze type value sent in the changes parameter. As out the November 1 release, the webhook returns the following data:

  • freeze_reason
  • freeze_required_actions

Webhook example payload:

{
"id": "8c8636e8-7cbf-4f73-b1bc-c44f9b8cfce1",
"account-id": "504e507e-4e0a-490d-b6cf-336f3dffa479",
"action": "update",
"data": {
"freeze_reason": "AF04: Missing Due Diligence",
"freeze_required_actions": [
"NF07: Provide updated identity documentation",
"NF06: Approve or deny wire recall request",
"NF02: Please provide proof of account ownership",
"NF04: Please contact Customer Support at support@primetrust.com or your Account Manager",
"NF09: Please contact fraudops@primetrust.com",
"NF08: Please contact primetrust.inquiries@primetrust.com",
"NF10: Please Review Kyc required information"
]
},
"resource-id": "504e507e-4e0a-490d-b6cf-336f3dffa479",
"resource-type": "accounts",
"account_id": "504e507e-4e0a-490d-b6cf-336f3dffa479",
"resource_id": "504e507e-4e0a-490d-b6cf-336f3dffa479",
"resource_type": "accounts"

The follow freeze codes may be included as payload values:

Freeze codeDescription
AF1ACH Reversal
AF2Customer Request
AF3Chargeback
AF4Missing Due Diligence
AF5Compliance Review
AF6Past Due
AF7FIU Review
AF8Wire Recall
AF9Activity Review
AF10Fraud Review

The following unfreeze required actions may be included as payload values:

Required actionDescription
NF1Offboarding
NF2Please provide proof of account ownership
NF3Please complete and sign due diligence questionnaire and submit required documentation. Contact your Account Manager.
NF4Please contact Customer Support at support@primetrust.com or your Account Manager
NF5Please contact billing@primetrust.com to settle outstanding invoices
NF6Approve or deny wire recall request
NF7Provide updated identity documentation
NF8Please contact primetrust.inquiries@primetrust.com
NF9Please contact fraudops@primetrust.com
NF10Please Review Kyc required information

Legacy webhook payload example (from before November 1, 2021), showing only changes value as "disbursement-frozen":

{
"id": "c9662d50-7d17-4b61-b878-ce48399c6b7e",
"account-id": "4d0969fd-036c-44bf-b0ca-f741b5506798",
"action": "update",
"data": {
"changes": [
"disbursements-frozen"
]
},
"resource-id": "4d0969fd-036c-44bf-b0ca-f741b5506798",
"resource-type": "accounts",
"account_id": "4d0969fd-036c-44bf-b0ca-f741b5506798",
"resource_id": "4d0969fd-036c-44bf-b0ca-f741b5506798",
"resource_type": "accounts"
}

Legacy webhook payload example (from before November 1, 2021), showing only changes value as "contributions-frozen":

{
"id": "fdcf2103-7939-40ea-9b81-8a62df7df45e",
"account-id": "4d0969fd-036c-44bf-b0ca-f741b5506798",
"action": "update",
"data": {
"changes": [
"contributions-frozen"
]
},
"resource-id": "4d0969fd-036c-44bf-b0ca-f741b5506798",
"resource-type": "accounts",
"account_id": "4d0969fd-036c-44bf-b0ca-f741b5506798",
"resource_id": "4d0969fd-036c-44bf-b0ca-f741b5506798",
"resource_type": "accounts"
}
Last updated on