Skip to navigation

Send payment method link

View as Markdown

Emails your customer a secure link to manage their saved payment methods — view, add, set a default, or remove a card or bank account. This is the same link the “Send link” button in your dashboard sends.

By default the link goes to the customer’s primary billing contact. Pass contactIds to send it to specific contacts instead, and set sendToPrimaryContact to true to include the primary billing contact as well. Each address gets its own email with its own link, once, even if it’s listed more than once.

The link is time-limited, and each call sends a fresh one. The response tells you which addresses it went to and how long it stays valid.

Authentication

Authorizationstring
API Key authentication via header

Path parameters

idstringRequired
Customer ID

Request

This endpoint expects an object.
contactIdslist of stringsOptional

IDs of the customer’s contacts to send the link to — the id values from GET /v3/customers/{id}/contacts. Each contact must belong to this customer and have an email on file. When omitted or empty, the link goes to the primary billing contact only.

sendToPrimaryContactbooleanOptionalDefaults to false

When contactIds is provided, also send the link to the customer’s primary billing contact. Ignored when contactIds is omitted or empty.

Response

Link sent to the requested contacts
payloadobject
Response payload, will be empty when success is false
successboolean

Boolean with true=success, false=failure

messagestring

Plain-text description of the result

errorobjectOptional
json element with any error messages or warnings

Errors

400
Bad Request Error
404
Not Found Error
500
Internal Server Error