Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewUnderstanding Payments for PlatformsChoose your Payments for Platforms solution
Use cases
PSP agnostic
Implement your PSP-agnostic solution
Get startedHandle settlementsDeposit matchingTroubleshooting
PSP settlement statusesFunds and data flows
Hold & convert funds

Troubleshooting

What to do if the intent and deposits don’t match, i.e., status is ACTION_REQUIRED?

  • Intermediate banks may split a PSP settlement into multiple deposits. If the deposit amount is less than the intent amount, the platform may need to wait for additional deposits to come in before you receive matched webhooks.
  • Specify deposits in a PSP settlement intent’s associate_by_deposit_ids field. This field will be used for matching, and the intent’s and deposits’ references will be ignored.

For all the possible causes that result in status ACTION_REQUIRED, see Failure notifications.

What to do if releases fail because of insufficient funds?

This could happen because the Collateral Account has insufficient balance (see Scenario 1), or because the seller doesn’t have enough money for a refund (see Scenario 2).

Scenario 1: Collateral Account has insufficient balance

To resolve this, the platform should top up funds into the Collateral Account. This can be done by sending funds to a Global Account of the Collateral Account.

Scenario 2: Seller doesn’t have enough money for a refund

To resolve this, the platform can wait for the seller account to have sufficient funds, due to additional sales, and then retry the release of the debit-type split. If the seller is not doing sales anymore, the platform and the seller should resolve this between them. The platform can add funds to the seller account, and then retry the release of the debit-type split. They can do so via:

What to do if releases fail because of other reasons?

If releasing a PSP settlement split fails for reasons other than insufficient funds, you can try to release it again, or contact Airwallex.