Create Google Ads payment setup

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "success_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done",
  "cancel_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup"

payload = {
    "success_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done",
    "cancel_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing"
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    success_url: 'https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done',
    cancel_url: 'https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup', 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://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'success_url' => 'https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done',
    'cancel_url' => 'https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup"

	payload := strings.NewReader("{\n  \"success_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done\",\n  \"cancel_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing\"\n}")

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

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"success_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done\",\n  \"cancel_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup")

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

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"success_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done\",\n  \"cancel_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing\"\n}"

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

{
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_a1B2c3D4e5",
  "session_id": "cs_live_a1B2c3D4e5"
}

Billing

Create Google Ads payment setup

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Starts the flow for saving a card against the workspace’s ad spend, and returns the page a person completes.

Google Ads spend is charged to a card on file. When Get Google Ads workspace debt reports requires_payment_method or requires_payment_refresh, this is what produces the link to fix it. Nothing is charged here, the session only validates and saves the card.

Send the two URLs Stripe should return the person to. Both must be https:// on a base44.com or base44.app host, so the return trip always lands back inside Base44 rather than on a site you name. A URL outside that set is rejected with a 400.

Base44 never accepts card details through this API, and neither should you. This endpoint only produces the page a person fills in.

Use Create embedded Google Ads payment setup instead when you are rendering the card form inside your own page rather than sending someone to Stripe.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

POST

api

apps

{app_id}

google-ads

billing

payment-setup

Create Google Ads payment setup

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "success_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done",
  "cancel_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup"

payload = {
    "success_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done",
    "cancel_url": "https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing"
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    success_url: 'https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done',
    cancel_url: 'https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup', 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://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'success_url' => 'https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done',
    'cancel_url' => 'https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup"

	payload := strings.NewReader("{\n  \"success_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done\",\n  \"cancel_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing\"\n}")

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

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"success_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done\",\n  \"cancel_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/billing/payment-setup")

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

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"success_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done\",\n  \"cancel_url\": \"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing\"\n}"

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

{
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_a1B2c3D4e5",
  "session_id": "cs_live_a1B2c3D4e5"
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose Google Ads campaigns to manage.

Body

application/json

success_url

string

required

Where Stripe sends the person after they save a card. It must be an https:// URL on a base44.com or base44.app host, with no credentials in it, so you cannot send them back to your own site.

Example:

"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing?setup=done"

cancel_url

string

required

Where Stripe sends the person if they abandon the form. Same host rules as success_url.

Example:

"https://app.base44.com/apps/6820f3a4e7b91d003c45a1f2/settings/billing"

Response

The page a person completes to save a card.

A Stripe Checkout session for saving a card.

checkout_url

string

required

Stripe-hosted page where a person enters their card details. Hand this to a human rather than trying to complete it programmatically. It expires, so fetch it when someone is ready to use it.

Example:

"https://checkout.stripe.com/c/pay/cs_live_a1B2c3D4e5"

session_id

string

required

Stripe's ID for the session. Useful for correlating with your own logs; the API takes it nowhere.

Example:

"cs_live_a1B2c3D4e5"

Overview

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Create Google Ads payment setup

Authorizations

Path Parameters

Body

Response