When a payment fails or encounters an issue, use the following steps to diagnose the problem.
Checking payment status in the Dashboard
- Log in to the Flinks Dashboard.
- Navigate to Payments.
- Click the Error tab to view failed payments.
- Select a payment to view its details, including the
paymentStatus and statusDetails fields.
Checking payment status via API
Use the /PaymentRequests GET endpoint to check the status of a payment:
curl -X GET \
https://{baseurl}/api/v1/paymentrequests/{requestId} \
-H 'Authorization: Bearer {access_token}' \
-H 'BaseURI: {instance}'
Payment status reference
| Status | Description |
|---|
Initiated | Payment request received and ready for processing |
Processing | User is completing the transaction |
Accepted | User accepted the payment; funds flow has started (funds guaranteed) |
Processed | Transaction processed; awaiting settlement |
Settled | Funds transfer completed to your account |
Cancelled | Payment cancelled before being initiated |
Expired | User did not action the request in time |
Declined | User declined the payment at their financial institution |
Failed | Payment request failed (check statusDetails for reason) |
- Open your browser’s Developer Tools (F12 or Ctrl+Shift+I).
- Go to the Network tab.
- Search for
SearchLiveTransactionHistories in the network requests.
- Inspect the response to find the
paymentStatus and statusDetails fields.
CPA005 error codes
CPA005 errors are Canadian Payments Association return codes that indicate why an EFT transaction was rejected by the receiving financial institution.
| Code | Description |
|---|
900 | Account closed |
901 | No account / account not found |
902 | Account frozen |
903 | Invalid account number |
905 | No debit allowed |
907 | Payment refused by customer |
908 | Funds not cleared |
910 | Payor / payee deceased |
911 | Account currency mismatch |
912 | Incorrect payor / payee name |
914 | Payment stopped |
990 | Institution in default |
CPA005 errors are specific to Canadian EFT transactions. If you encounter a CPA005 error, the payment will need to be re-initiated after resolving the underlying issue with the customer’s bank account.
Common issues
| Problem | Possible cause | Solution |
|---|
Payment stuck in Processing | User hasn’t completed the flow | Follow up with the customer or check if the session expired |
Failed with failed_name_matching | Name mismatch between session and bank | Create a new session with the correct name |
Payment Expired | User didn’t action the e-transfer request | Initiate a new payment request |
| CPA005 rejection | Bank rejected the EFT transaction | Check the specific CPA005 code and work with the customer |
