The cnpAPI Data Format

There are several advantages to using the cnpAPI format as follows:

  • Easier Implementation, Operations, and Debugging - Compared to fixed length or binary formats, the XML format is considerably easier for operations staff to read and edit, using virtually any text editor. This allows Worldpay’s Implementation, First Line Support, and Relationship Managers to quickly communicate any issues and work with your own operations staff to make necessary corrections without worrying about line lengths, padding or encoding.

  • Fewer Downgrades - Since the cnpAPI format allows you to explicitly tie deposits to their associated authorizations via the <cnpTxnId> element, your transactions qualify for the best interchange rates at a higher frequency than with formats that do not support this transaction cross-referencing.

  • Simpler Capture (Deposit) and Refund Transactions - Because the cnpAPI format associates related transactions using the <cnpTxnId> element, our format does not require you to resubmit all of the authorization information on a deposit nor all of the deposit information on a refund. When you submit the unique transaction id, Worldpay automatically pulls the information from the original transaction. Most other formats require you to resubmit the related data with each transaction.

  • Superior Reporting - The cnpAPI format allows you to separate your transactions into different categories by specifying a Report Group on each transaction. When accessing your data on the iQ reporting and Analytics Interface, this feature allows you to filter your financial reports by Report Groups, providing more granular detail based on a reporting hierarchy the Report Groups create. Most other formats restrict reporting categories to a batch or specific merchant id.

  • Improved Chargeback Management - Unlike most other formats where transactional relationships can be a “best guess” proposition, the cnpAPI format explicitly ties related transactions, allowing you and Worldpay to see authorization-to-deposit and deposit-to-refund relationships with precision. This knowledge is indispensable when fighting chargebacks.

  • New Features - New features developed for the Worldpay eCommerce platform are first exposed via the cnpAPI. While the SDKs add new capabilities shortly after development, direct coding to the cnpAPI gains access to these feature and capabilities earlier.