Unicorn

The Unicorn Documentation Hub

Welcome to the Unicorn documentation hub where you'll find useful information to help you start working with Unicorn as quickly as possible.

Guides    

Understanding Unicorn

Unicorn, from Cross River Bank (CRB), provides you with a channel to send all your payment instructions in one single file format (XML).

The Unicorn system processes input files from you, records financial movements, and sends Payment Status Reports (PSRs) as output files to update you about payment processing, rejections, and returns. The input files must conform to the ISO 20022 PAIN.001.001.03 and PAIN.008.001.02 standards, and the PSRs conform to the ISO 20022 PAIN002.001.03 standard.

Unicorn supports these payment methods (rails):

The rails that you use for payment processing depend on your agreement with CRB. Setup of your rails is performed with the client support team during your onboarding process.

In this guide we'll explain how to create the files correctly and how to send them to CRB. We've included examples of input files and PSRs, together with explanations of their blocks and elements. We've also included return statuses and error codes so you can understand what's happening with your files.

Note: You can find detailed information about the ISO 20022 message definitions on the ISO site here.

You can reach out to Unicorn support for any questions.

Acknowledgment files containing initial processing information are normally available within minutes. After that, Unicorn checks for updates based on rail type:

For ACH:

  • Unicorn will check COS for returns and NOCs once on the effective date provided in the response COS, then once a day for an additional three business days, and then once a week for up to 6 months.

  • Unicorn will check COS for Processed, Rejected and OnHold statuses once on the effective date provided in the response COS and then once a day for an additional three business days.

The checks will take place at 20:00 for ACH.

Note: Effective date is the day the payment came in, or the next business day if the payment came in after the cutoff time set in COS.

For Wires:

Unicorn will check COS for status updates at 18:00 on the business day that the payment was supposed to be processed, and also at 18:00 on the business day after that.

For XPay/Core transactions:

Unicorn will check COS for status updates every 30 minutes.

Updated 25 days ago

Understanding Unicorn


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.