Airwallex logo
Airwallex logo

Set up the Platform Liquidity Program

Configure PLP to fund customer card transactions from a central pool

To enable just-in-time funding for your customers' card transactions using the Platform Liquidity Program (PLP), complete the steps in this document. PLP eliminates the need to pre-load individual Connected Accounts, simplifying operations and improving cash flow.

Before you begin

Before setting up the PLP, ensure you have:

  • An active Airwallex platform account
  • Created Connected Accounts for your customers.
  • Contacted your Account Executive to request PLP setup.
  • Received your unique program_id from your Account Executive.

For conceptual background on how the PLP works, see Issuing funding sources.

Verify your PLP setup

After your Account Executive creates your PLP, verify the setup and check your available limits.

  1. Call the Get a Program API endpoint using your program_id:

    Shell
    1curl --request GET \
    2  'https://api.airwallex.com/api/v1/platform_liquidity_programs/{program_id}' \
    3  -H 'Authorization: Bearer <your_access_token>'

  2. Review the response to confirm your program details:

    JSON
    1{
    2  "id": "plp_1234567890",
    3  "name": "My PLP",
    4  "status": "ACTIVE",
    5  "limit_balances": {
    6    "USD": {
    7      "total_amount": 100000.00,
    8      "available_amount": 100000.00
    9    }
    10  }
    11}

The response includes:

  • status: Confirms your PLP is ACTIVE.
  • limit_balances.total_amount: Shows the current cash position in your PLP Settlement Account.
  • limit_balances.available_amount: Shows the immediate spending capacity (PLP Limit) for all Connected Accounts.

Create Program Spending Accounts

Link each Connected Account to your PLP by creating a Program Spending Account. This enables cards associated with that Connected Account to draw from your centralized PLP funds.

  1. Call the Create a Program Spending Account API endpoint for each Connected Account:

    Shell
    1curl --request POST \
    2  'https://api.airwallex.com/api/v1/platform_liquidity_programs/{program_id}/program_spending_accounts/create' \
    3  -H 'Authorization: Bearer <your_access_token>' \
    4  -H 'Content-Type: application/json' \
    5  -d '{
    6    "connected_account_id": "ca_1234567890"
    7  }'

  2. Save the funding_source_id from the response:

    JSON
    1{
    2  "id": "psa_9876543210",
    3  "funding_source_id": "fs_1122334455",
    4  "connected_account_id": "ca_1234567890",
    5  "status": "ACTIVE"
    6}

You'll use this funding_source_id when creating cards to link them to the PLP.

Fund your PLP

Transfer funds from your Airwallex Wallet to your PLP Settlement Account to enable card transactions.

  1. Call the Deposit API endpoint to transfer funds:

    Shell
    1curl --request POST \
    2  'https://api.airwallex.com/api/v1/platform_liquidity_programs/{program_id}/deposit' \
    3  -H 'Authorization: Bearer <your_access_token>' \
    4  -H 'Content-Type: application/json' \
    5  -d '{
    6    "amount": 50000.00,
    7    "currency": "USD"
    8  }'

  2. Verify the deposit by calling the Get a Program endpoint again and confirming the available_amount increased by your deposit amount.

You can fund in multiple currencies. Each currency creates a separate PLP Limit for that currency.

Note: To transfer funds back to your Airwallex Wallet, use the Withdraw API endpoint.

When creating cards for your customers, specify the funding_source_id from the Program Spending Account to enable PLP funding.

  1. Call the Create a Card API endpoint with the funding_source_id:

    Shell
    1curl --request POST \
    2  'https://api.airwallex.com/api/v1/issuing/cards/create' \
    3  -H 'Authorization: Bearer <your_access_token>' \
    4  -H 'Content-Type: application/json' \
    5  -d '{
    6    "cardholder_id": "ch_1234567890",
    7    "card_type": "VIRTUAL",
    8    "funding_source_id": "fs_1122334455"
    9  }'

  2. Confirm the card was created successfully and note the card_id in the response.

The card is now linked to the PLP. When your customer makes a transaction, funds will be drawn from your centralized PLP Settlement Account rather than the individual Connected Account.

Configure low balance alerts

Set up webhook notifications to monitor your PLP balance and receive alerts when funds run low.

  1. Configure a webhook endpoint to receive PLP events (see Listen for webhook events).

  2. Subscribe to the platform_liquidity_program.low_balance event type.

  3. Define your low balance threshold when your Account Executive sets up your PLP, or contact them to adjust it.

When your PLP Limit falls below the threshold, Airwallex sends a webhook notification to your configured endpoint, allowing you to proactively add funds.

Next steps

Now that you've set up the PLP, you can:

Was this page helpful?