GET

Airbnb Payment Methods API

Get available payment methods and payment plans for any Airbnb listing.

Overview

Payment Options

Payment methods include credit cards, PayPal, Apple Pay, and split payment plans when available.

The Payment Methods endpoint returns all available payment options for a listing, including payment plans that allow splitting the total across multiple payments.

Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/{listing_id}/payment-methods

Parameters

Parameter	Type	Required	Description
listing_id	integer	Required	Airbnb listing ID (path parameter)
check_in	string	Required	Check-in date in YYYY-MM-DD format
check_out	string	Required	Check-out date in YYYY-MM-DD format
adults	integer	Optional	Number of adults (1-16, default: 1)
currency	string	Optional	Currency code (default: USD)

Response Structure

Payment Methods

title - Payment method name
type - Payment type (CARD, PAYPAL, etc.)
icon_url - Payment method icon

Payment Plans

title - Plan name (e.g., "Pay in full", "Pay part now")
subtitle - Plan description
installments - Array of payment installments

Request

curl -X GET "https://api.stayapi.com/v1/airbnb/listing/22135033/payment-methods?check_in=2026-01-30&check_out=2026-02-01" \
  -H "x-api-key: YOUR_API_KEY"

const listingId = 22135033;
const params = new URLSearchParams({
  check_in: "2026-01-30",
  check_out: "2026-02-01"
});

const response = await fetch(
  `https://api.stayapi.com/v1/airbnb/listing/${listingId}/payment-methods?${params}`,
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();

// List payment methods
console.log("Payment Methods:");
data.payment_methods.payment_methods.forEach(m => {
  console.log(`- ${m.title}`);
});

// List payment plans
console.log("\nPayment Plans:");
data.payment_methods.payment_plans.forEach(p => {
  console.log(`- ${p.title}: ${p.subtitle}`);
});

import requests

listing_id = 22135033
url = f"https://api.stayapi.com/v1/airbnb/listing/{listing_id}/payment-methods"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {
    "check_in": "2026-01-30",
    "check_out": "2026-02-01"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

# List payment methods
print("Payment Methods:")
for m in data["payment_methods"]["payment_methods"]:
    print(f"  - {m['title']}")

# List payment plans
print("\nPayment Plans:")
for p in data["payment_methods"]["payment_plans"]:
    print(f"  - {p['title']}: {p['subtitle']}")

<?php
$listingId = 22135033;
$url = "https://api.stayapi.com/v1/airbnb/listing/" . $listingId . "/payment-methods";
$params = http_build_query([
    "check_in" => "2026-01-30",
    "check_out" => "2026-02-01"
]);

$ch = curl_init($url . "?" . $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

echo "Payment Methods:\n";
foreach ($data["payment_methods"]["payment_methods"] as $m) {
    echo "  - " . $m["title"] . "\n";
}
?>

require "net/http"
require "json"
require "uri"

listing_id = 22135033
uri = URI("https://api.stayapi.com/v1/airbnb/listing/\#{listing_id}/payment-methods")
uri.query = URI.encode_www_form({
  check_in: "2026-01-30",
  check_out: "2026-02-01"
})

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

request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "YOUR_API_KEY"

response = http.request(request)
data = JSON.parse(response.body)

puts "Payment Methods:"
data["payment_methods"]["payment_methods"].each do |m|
  puts "  - \#{m['title']}"
end

puts "\nPayment Plans:"
data["payment_methods"]["payment_plans"].each do |p|
  puts "  - \#{p['title']}: \#{p['subtitle']}"
end

Response

{
  "success": true,
  "listing_id": 22135033,
  "check_in": "2026-01-30",
  "check_out": "2026-02-01",
  "nights": 2,
  "payment_methods": {
    "payment_methods": [
      {
        "title": "Credit or debit card",
        "type": "CARD",
        "icon_url": "https://a0.muscache.com/..."
      },
      {
        "title": "PayPal",
        "type": "PAYPAL",
        "icon_url": "https://a0.muscache.com/..."
      },
      {
        "title": "Apple Pay",
        "type": "APPLE_PAY",
        "icon_url": "https://a0.muscache.com/..."
      }
    ],
    "payment_plans": [
      {
        "title": "Pay in full",
        "subtitle": "Pay the total ($104.13) now",
        "is_default": true,
        "installments": [
          {
            "amount": "$104.13",
            "due_date": "Today"
          }
        ]
      },
      {
        "title": "Pay part now, part later",
        "subtitle": "Pay $52.07 now, $52.06 on Jan 15",
        "is_default": false,
        "installments": [
          {
            "amount": "$52.07",
            "due_date": "Today"
          },
          {
            "amount": "$52.06",
            "due_date": "Jan 15, 2026"
          }
        ]
      }
    ]
  }
}

{
  "error": "Invalid dates",
  "detail": "check_out must be after check_in",
  "status_code": 400
}