Skip to main content
POST
Add a payment method
  • Send enrollment_url to the cardholder. It expires after 30 minutes. Card details go only to that page, never to Pomerado.
  • The payment method is pending_enrollment until they finish; list payment methods to see it active.
  • A Visa or Mastercard card can pay once its can_pay is true.
  • Callers: an API key, an MCP OAuth token or a Dashboard session.
  • Permission: runs:create.
  • Effect: Creates or changes something.
  • Errors: payer_profile_not_found, payment_method_limit, payment_vendor_unavailable, and the errors any request can get.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

payer_ and 32 lowercase hex digits

Response

The new payment method and its one-time enrollment page

payment_method
object
required
enrollment_url
string
required

The single-use page where the cardholder enters the card, shown only in this response. Send it to the cardholder; it expires after 30 minutes

expires_at
string | null
required

a string to be decoded into a Date