action britbox_add_payment_method { label: "addPaymentMethod" description: "Add a new payment method to an account." provider: britbox method: POST path: "/account/billing/methods" encoding: json input: { type: "object" required: ["token", "type"] properties: { makeDefault: { type: "boolean" description: "Whether this payment method should become the account default when \nmaking purchases.\n\nNote that if this is the first payment method of type Card being added to an\naccount then it will become the default whether this property is true or false.\n" } token: { type: "string" description: "The payment provider token representing a payment method, obtained by\nsubmitting payment method details to your third party provider.\n" } type: { type: "string" description: "The type of payment method." enum: ["Card"] } } additionalProperties: false } output: { type: "object" required: ["description", "id", "type"] properties: { balance: { type: "number" format: "float" description: "The balance of the wallet if the payment method is a wallet." } brand: { type: "string" description: "The brand of the card if the payment method is a card." enum: ["Visa", "MasterCard", "AmericanExpress", "Other"] } currency: { type: "string" description: "The currency code of the wallet if the payment method is a wallet." } description: { type: "string" description: "A short description of a payment method.\n\nIf the payment method is of type `Wallet` this will be \"My Wallet\"\n\nFor `Card` type payment methods the format of this description may differ\ndepending on the payment gateway in use. In the case of Stripe, this will\nbe in the format \"Visa (**** 4242, exp 08/19)\"\n" } expiryMonth: { type: "number" format: "int32" description: "The expiry month of the card if the payment method is a card." } expiryYear: { type: "number" format: "int32" description: "The expiry year of the card if the payment method is a card." } id: { type: "string" description: "The unique identifier of a payment method." } lastDigits: { type: "number" format: "int32" description: "The last digits of the card if the payment method is a card.\nDepending on the payment gateway in use this value may be undefined.\n" } type: { type: "string" description: "The type of payment method." enum: ["Card", "Wallet"] } } additionalProperties: false } }