Beneficiary

This endpoint enables you to verify a payee’s account details with their bank prior to creating a beneficiary or initiating a payment. Based on the response returned by the system integrator, Toqio's UI will provide appropriate feedback to the user.

📣

To activate the CoP flow, please contact Toqio's Delivery Team to ensure that Confirmation of Payee (CoP) capability is enabled for your banking provider.

status

  • MATCHED: The beneficiary’s details have been successfully verified. No warning will be shown to the user.
  • PARTIALLY_MATCHED: The beneficiary’s details are partially verified. A warning will be shown to the user, who may choose to proceed or cancel the payment.
  • NOT_MATCHED: The beneficiary’s details could not be verified. A critical warning will be shown to the user, who may choose to proceed or cancel the payment.
  • NOT_APPLIED: The Confirmation of Payee service is not applicable to this beneficiary. No feedback will be shown to the user.

reasonCode : Reason code for a more detailed description of the kind of match

reasonDescription: Detailed description of the reason code. If provided by the SI, this message will be displayed in the warning feedback shown to the user.