Disbursing Funds from a Liquidity Account

When you need to move funds from a Liquidity Account to an external bank account, you can do so using the Ping Credit payment method with a specific configuration..

How It Works

For disbursements:

• The source of funds is the Liquidity Account, specified as provider_method_parameters.liquidity_account_id.
• The recipient is one of your onboarded merchants, specified as order_items[].merchant_id. The merchant’s settlement setup (e.g. bank account and schedule) determines how and when the funds are paid out.

From an integration perspective, this works just like a normal payment to a merchant, but using a payment method that draws funds from the Liquidity Account instead of from an external payer’s bank account.

Example

Request

curl --location 'https://sandbox.pingpayments.com/payments/api/v1/payment_orders/<YOUR-PAYMENT-ORDER-ID>/payments' \
--header 'x-api-secret: <YOUR-API-SECRET>' \
--header 'tenant_id: <YOUR-TENANT-ID>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_items": [
      {
        "amount": 29900,
        "metadata": {},
        "name": "Transfer",
        "merchant_id": "10140b8f-7ed6-4d27-8bdb-648955df00ca",
        "vat_rate": "0",
        "tags": []
      }
    ],
    "provider_method_parameters": {
        "liquidity_account_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaa"
    }, 
    "metadata": {},
    "currency": "SEK",
    "method": "credit",
    "provider": "ping",
    "status_callback_url": "https://<YOUR-DOMAIN>/ping-callback/payment_status",
    "total_amount": 29900
}'

Once the Payment has been completed and the Payment Order is settled, the funds are disbursed from the Liquidity Account to the merchant and then paid out to the configured bank account according to the agreed-upon schedule.