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
PSP settlement statuses
Funds and data flows
Hold & convert funds

PSP settlement statuses

This page describes the status transitions for the PSP settlement objects, namely PSP settlement intent, PSP settlement split, and PSP settlement deposit, when you process settlements received from acquiring PSPs into seller's connected accounts.

PSP settlement intent

Status transitions for a PSP settlement intent object during settlement handling.

PSP Settlement Intent status

Status Description Emitted webhook Next steps
NEW The PSP settlement intent has been successfully created on the server. psp_settlement_intent.new You can proceed to define the splits using Split a PSP settlement intent. For more information, see Share settlement data.
SUBMITTED The PSP settlement intent has been submitted and is available for matching with PSP settlement deposits. psp_settlement_intent.submitted Wait for the acquiring PSP to deposit the funds described in the PSP settlement intent.
ACTION_REQUIRED Unsuccessful match between the PSP settlement intent and deposit(s). psp_settlement_intent.action_required See Failure notifications.
MATCHED The amount of the PSP settlement intent, i.e., the sum of the amounts of all its PSP settlement splits, matches the amount of the associated PSP settlement deposit(s). psp_settlement_intent.matched You can proceed to release settlement splits comprising this intent. See Release settlement split.
SETTLED Platform has successfully released all the PSP settlement splits comprising the intent and the funds have moved from the Holding Account into the sellers' connected account wallets.

The platform may also have created splits to represent fees, which move funds from the Holding Account to the platform’s Wallet.
psp_settlement_intent.settled Pay out funds from the sellers’ connected accounts to their external bank accounts whenever you choose.
CANCELLED The PSP settlement intent, and all of its PSP settlement splits, has been cancelled by the platform. psp_settlement_intent.cancelled If the intent was cancelled because incorrect data was shared by the platform then create a new PSP settlement intent and start over. See Share settlement data.

You can subscribe to PSP Settlement Intent webhooks to receive notifications on these status transitions.

PSP settlement split

Status transitions for a PSP Settlement Split object during settlement handling.

PSP Settlement Split statuses

Status Description Emitted webhook Next steps
NEW The PSP settlement split has been successfully created on the server. psp_settlement_split.new No action needed.
MATCHED The PSP settlement intent containing this split has been successfully matched with the associated PSP settlement deposit(s). psp_settlement_split.matched You can proceed to release the PSP settlement split. See Release settlement split.
PENDING Platform has released the PSP settlement split but the funds are yet to be settled in the seller's connected account wallet. psp_settlement_split.pending Wait to receive notification on the success or failure of the settlement.
SETTLED Platform has successfully released a PSP settlement split and the funds have moved from the Holding Account into the seller's connected account wallet (CREDIT split) or vice versa (DEBIT split). psp_settlement_split.settled No action needed.
FAILED Platform has released a PSP settlement split but the settlement has failed. psp_settlement_split.failed See Release settlement split for information on how to handle release failure notifications.
CANCELLED The PSP settlement split has been cancelled as the platform shared incorrect data with Airwallex or because it was a duplicate. psp_settlement_split.cancelled If cancelled due to incorrect data then you can create a new settlement split immediately after cancellation. See Cancel a PSP settlement split.

You can subscribe to PSP Settlement Split webhooks to receive notifications on these status transitions.

PSP settlement deposit

Status transitions for a PSP settlement deposit object during settlement handling.

PSP Settlement deposit status

Status Description Emitted webhook Next steps
NEW Airwallex has successfully created the PSP settlement deposit object. This occurs when the acquiring PSP deposits the funds to a Global Account connected to the platform's Holding Account using a predetermined settlement reference in the bank transfer description. psp_settlement_deposit.new No action needed.
ACTION_REQUIRED Unsuccessful match between the deposit and PSP settlement intents. psp_settlement_deposit.action_required For information on the types of unsuccessful matches and how to troubleshoot, see Failure notifications.
MATCHED The amount of the PSP settlement deposits matches the amount of the associated PSP settlement intent. psp_settlement_deposit.matched You can proceed to release settlement splits comprising this intent. See Release settlement split.
SETTLED Platform has successfully released all the PSP settlement splits comprising the intent and the funds have moved from the Holding Account into the sellers' connected account wallets. psp_settlement_deposit.settled Pay out funds from the sellers’ connected accounts to their external bank accounts whenever you choose.

You can subscribe to PSP Settlement Deposit webhooks to receive notifications on these status transitions.

Linked statuses

  • When a PSP settlement intent is cancelled (status CANCELLED), the associated PSP settlement splits are also set to CANCELLED but the psp_settlement_split.cancelled webhook is not sent.
  • When the amount of the PSP settlement deposits matches the associated PSP settlement intent, the status of the matched intent, splits, and deposits will all be simultaneously changed to MATCHED, and webhooks of type matched will be sent for all objects.
  • When all PSP settlement splits are settled, the intent and deposit statuses simultaneously change to SETTLED.
On this page
  • PSP settlement intent
  • PSP settlement split
  • PSP settlement deposit
  • Linked statuses