Payment Methods API — list and manage saved cards

A payment method represents a saved payment instrument attached to a customer. Payment methods are created when a customer completes checkout with save_payment_method: true. Use these endpoints to list, retrieve, detach, or set a default method on the customer. Supported types

Type	Description
`card`	Credit or debit card.
`apple_pay`	Apple Pay wallet.
`google_pay`	Google Pay wallet.
`bank_invoice`	Bank invoice (gíróseðill).

List payment methods

GET /v1/payment_methods Returns a paginated list of payment methods for a customer.

Query parameters

string

Filter by customer ID. Recommended — without this filter the endpoint returns methods across all customers on your merchant account.

string

Cursor for pagination. Pass the id of the last payment method from the previous page to retrieve the next page.

number

Maximum number of payment methods to return per page.

curl --request GET \
  --url "https://api.borga.is/v1/payment_methods?customer=cus_abc123&limit=20" \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

object[]

required

Array of payment method objects.

Show payment method fields

string

required

Unique payment method identifier.

string

required

ID of the customer this method belongs to.

string

required

Payment method type. One of card, apple_pay, google_pay, bank_invoice.

object

Card details. Present when type is card, apple_pay, or google_pay.

Show card fields

string

required

Card network (e.g. visa, mastercard, amex).

string

required

Last four digits of the card number.

number

required

Two-digit expiry month (1–12).

number

required

Four-digit expiry year.

string

required

ISO 8601 creation timestamp.

boolean

required

Whether more payment methods exist beyond this page.

{
  "data": [
    {
      "id": "pm_01hxa8w2qkfr5nt9vcj3dl7mbe",
      "customer": "cus_abc123",
      "type": "card",
      "card": {
        "brand": "visa",
        "last4": "4242",
        "exp_month": 12,
        "exp_year": 2028
      },
      "created_at": "2026-04-29T09:00:00Z"
    }
  ],
  "has_more": false
}

Retrieve a payment method

GET /v1/payment_methods/{id} Retrieves the details of a single payment method.

Path parameters

string

required

The ID of the payment method to retrieve.

curl --request GET \
  --url https://api.borga.is/v1/payment_methods/pm_01hxa8w2qkfr5nt9vcj3dl7mbe \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

string

required

Unique payment method identifier.

string

required

ID of the customer this method belongs to.

string

required

Payment method type. One of card, apple_pay, google_pay, bank_invoice.

object

Card details. Present when type is card, apple_pay, or google_pay.

Show card fields

string

required

Card network (e.g. visa, mastercard, amex).

string

required

Last four digits of the card number.

number

required

Two-digit expiry month (1–12).

number

required

Four-digit expiry year.

string

required

ISO 8601 timestamp of when the payment method was saved.

{
  "id": "pm_01hxa8w2qkfr5nt9vcj3dl7mbe",
  "customer": "cus_abc123",
  "type": "card",
  "card": {
    "brand": "visa",
    "last4": "4242",
    "exp_month": 12,
    "exp_year": 2028
  },
  "created_at": "2026-04-29T09:00:00Z"
}

Detach a payment method

DELETE /v1/payment_methods/{id} Detaches a payment method from its customer. Once detached, the method can no longer be used for future payments. This action is irreversible.

Path parameters

string

required

The ID of the payment method to detach.

curl --request DELETE \
  --url https://api.borga.is/v1/payment_methods/pm_01hxa8w2qkfr5nt9vcj3dl7mbe \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

string

required

ID of the detached payment method.

boolean

required

Always true on a successful detach response.

{
  "id": "pm_01hxa8w2qkfr5nt9vcj3dl7mbe",
  "deleted": true
}

Set default payment method

POST /v1/payment_methods/{id}/set_default Sets a payment method as the default for the associated customer. The default method is used automatically for recurring charges and subscription renewals.

Path parameters

string

required

The ID of the payment method to set as default.

curl --request POST \
  --url https://api.borga.is/v1/payment_methods/pm_01hxa8w2qkfr5nt9vcj3dl7mbe/set_default \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

string

required

Unique payment method identifier.

string

required

ID of the customer this method belongs to.

string

required

Payment method type. One of card, apple_pay, google_pay, bank_invoice.

object

Card details. Present when type is card, apple_pay, or google_pay.

Show card fields

string

required

Card network (e.g. visa, mastercard, amex).

string

required

Last four digits of the card number.

number

required

Two-digit expiry month (1–12).

number

required

Four-digit expiry year.

string

required

ISO 8601 timestamp of when the payment method was saved.

{
  "id": "pm_01hxa8w2qkfr5nt9vcj3dl7mbe",
  "customer": "cus_abc123",
  "type": "card",
  "card": {
    "brand": "visa",
    "last4": "4242",
    "exp_month": 12,
    "exp_year": 2028
  },
  "created_at": "2026-04-29T09:00:00Z"
}

Overview

Payments

Subscriptions

Billing

Configuration

Payment Methods API — list and manage saved cards

List payment methods

Query parameters

Response fields

Retrieve a payment method

Path parameters

Response fields

Detach a payment method

Path parameters

Response fields

Set default payment method

Path parameters

Response fields

​List payment methods

​Query parameters

​Response fields

​Retrieve a payment method

​Path parameters

​Response fields

​Detach a payment method

​Path parameters

​Response fields

​Set default payment method

​Path parameters

​Response fields

List payment methods

Query parameters

Response fields

Retrieve a payment method

Path parameters

Response fields

Detach a payment method

Path parameters

Response fields

Set default payment method

Path parameters

Response fields