Payment method add — Airbnb

airbnb.payment_method.add

Verify a card with the issuer and add it to the Airbnb wallet

POST /v1/operations/airbnb.payment_method.add

Headers

Authorization: Bearer YOUR_AJAR_API_KEY
x-skyscanner-token: YOUR_SKYSCANNER_TOKEN
x-idempotency-key: YOUR_UNIQUE_ATTEMPT_KEY
Content-Type: application/json

x-idempotency-key identifies one intended action. Generate a unique value, such as crypto.randomUUID(), before sending it. Use 1–128 letters, numbers, hyphens, underscores or periods. A duplicate attempt is rejected; it does not return a cached success. If a request times out, check the provider’s state before starting a new attempt with a new key. See the idempotency guide.

Inputs

Parameter	Example type	Example value
number	string	"4111111111111111"
cvv	string	"123"
expiration_month	string	"12"
expiration_year	string	"2040"
first_name	string	"Example"
last_name	string	"Guest"
postal_code	string	"EXAMPLE"
currency	string	"GBP"
confirm_add	boolean	true

Example input

{
  "number": "4111111111111111",
  "cvv": "123",
  "expiration_month": "12",
  "expiration_year": "2040",
  "first_name": "Example",
  "last_name": "Guest",
  "postal_code": "EXAMPLE",
  "currency": "GBP",
  "confirm_add": true
}

Illustrative response for the example input. Availability, prices and result order vary. Replace example references and URLs with values returned by your own requests.

Example response

{
  "status": "requires_action",
  "continuation_ref": "00000000-0000-4000-8000-000000000001",
  "expires_in": 600,
  "action": "approve_in_bank_app",
  "currency": "GBP",
  "verification_amount": 0,
  "last_four": "1111"
}

Open JSON schema

Input schema

{
  "$id": "https://useajar.com/schemas/airbnb/payment-method-add.input.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "confirm_add": {
      "const": true
    },
    "currency": {
      "enum": [
        "AED",
        "AUD",
        "BRL",
        "BGN",
        "CAD",
        "CHF",
        "CLP",
        "CNY",
        "COP",
        "CRC",
        "CZK",
        "DKK",
        "EGP",
        "EUR",
        "GBP",
        "GHS",
        "HKD",
        "HUF",
        "IDR",
        "ILS",
        "INR",
        "JPY",
        "KES",
        "KRW",
        "KZT",
        "MAD",
        "MXN",
        "MYR",
        "NOK",
        "NZD",
        "PEN",
        "PLN",
        "PHP",
        "QAR",
        "RON",
        "SAR",
        "SEK",
        "SGD",
        "THB",
        "TRY",
        "TWD",
        "UAH",
        "UGX",
        "USD",
        "UYU",
        "VND",
        "ZAR"
      ],
      "type": "string"
    },
    "cvv": {
      "maxLength": 4,
      "minLength": 1,
      "pattern": "^[0-9]{3,4}$",
      "type": "string",
      "x-sensitive": true
    },
    "expiration_month": {
      "maxLength": 2,
      "minLength": 1,
      "pattern": "^(0[1-9]|1[0-2])$",
      "type": "string",
      "x-sensitive": true
    },
    "expiration_year": {
      "maxLength": 4,
      "minLength": 1,
      "pattern": "^[0-9]{4}$",
      "type": "string",
      "x-sensitive": true
    },
    "first_name": {
      "maxLength": 100,
      "minLength": 1,
      "type": "string",
      "x-sensitive": true
    },
    "last_name": {
      "maxLength": 100,
      "minLength": 1,
      "type": "string",
      "x-sensitive": true
    },
    "number": {
      "maxLength": 19,
      "minLength": 1,
      "pattern": "^[0-9]{12,19}$",
      "type": "string",
      "x-sensitive": true
    },
    "postal_code": {
      "maxLength": 100,
      "minLength": 1,
      "type": "string",
      "x-sensitive": true
    }
  },
  "required": [
    "number",
    "cvv",
    "expiration_month",
    "expiration_year",
    "first_name",
    "last_name",
    "postal_code",
    "currency",
    "confirm_add"
  ],
  "type": "object"
}