Billing

Pay the overdrawn credit balance now

Charges the saved card or bank account for what the credit balance is overdrawn by, now instead of at the next billing run: at least the rail’s smallest charge, any surplus added as credits, and no auto-reload top-up. Only for a company whose billing is paid from credits. It is the merchant’s own charge, so it works while automatic charges are blocked: a success lifts that block, a failure keeps it. A declined card returns the charge as failed, with its reason (201). Takes no body and no key. Only one charge runs at a time: while one is on its way a repeat is refused (409), and once the debt is paid a repeat finds nothing owed (422); neither charges. Needs billing.update; never a Droplet token.

POST

api

settings

billing

credits

pay-now

Pay the overdrawn credit balance now

curl --request POST \
  --url https://api.fluid.app/api/settings/billing/credits/pay-now \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.fluid.app/api/settings/billing/credits/pay-now"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fluid.app/api/settings/billing/credits/pay-now', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/settings/billing/credits/pay-now",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/settings/billing/credits/pay-now"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/settings/billing/credits/pay-now")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "credit_purchase": {
    "id": 7391,
    "origin": "settlement",
    "status": "succeeded",
    "instrument_type": "card",
    "failure_message": null,
    "invoice_available": false,
    "top_up_cents": 0,
    "amount_cents": 100000,
    "bonus_percent": 0,
    "bonus_cents": 0,
    "credit_cents": 100000,
    "refunded_cents": 0,
    "credits_expire_at": "2027-09-30T14:05:11Z",
    "created_at": "2026-09-30T14:05:09Z",
    "succeeded_at": "2026-09-30T14:05:11Z",
    "failed_at": null
  },
  "balance_cents": 0,
  "status": 201,
  "meta": {
    "request_id": "f3b8c2d1-6a4e-4f7b-9c1d-2e5a8b7c4d90",
    "timestamp": "2026-09-30T14:05:11Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer token authentication

Response

The charge was reserved and sent; its status says where the payment stands

The charge Pay now made.

credit_purchase

object

required

One purchase of credits: what was paid, what it granted, and where its money stands. succeeded means the credits were granted; processing means the payment is still settling. origin is manual (the merchant bought), auto_reload (a low balance bought), or settlement (a charge for what a credit-billed company owes, with any auto-reload top-up).

Show child attributes

balance_cents

integer

required

The credit balance after the charge

Pay the overdrawn credit balance now

curl --request POST \
  --url https://api.fluid.app/api/settings/billing/credits/pay-now \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.fluid.app/api/settings/billing/credits/pay-now"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fluid.app/api/settings/billing/credits/pay-now', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/settings/billing/credits/pay-now",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/settings/billing/credits/pay-now"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/settings/billing/credits/pay-now")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "credit_purchase": {
    "id": 7391,
    "origin": "settlement",
    "status": "succeeded",
    "instrument_type": "card",
    "failure_message": null,
    "invoice_available": false,
    "top_up_cents": 0,
    "amount_cents": 100000,
    "bonus_percent": 0,
    "bonus_cents": 0,
    "credit_cents": 100000,
    "refunded_cents": 0,
    "credits_expire_at": "2027-09-30T14:05:11Z",
    "created_at": "2026-09-30T14:05:09Z",
    "succeeded_at": "2026-09-30T14:05:11Z",
    "failed_at": null
  },
  "balance_cents": 0,
  "status": 201,
  "meta": {
    "request_id": "f3b8c2d1-6a4e-4f7b-9c1d-2e5a8b7c4d90",
    "timestamp": "2026-09-30T14:05:11Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Storefront

Commerce

Checkout

Members

Messaging

People

Payments

DAM

Website

Portal

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Portal & Widgets

Pay the overdrawn credit balance now

Authorizations

Response