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 | string | Required | Airbnb listing ID (path parameter). Use decimal digits as a string in client code to preserve long IDs. |
| 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
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"
```

Response

```json
{
  "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"
          }
        ]
      }
    ]
  }
}
```

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