Delete the default payment method for a customer

Deletes a customer's default payment method.

SecurityOAuth2
Request
path Parameters
contextName
required
string

The unique integration provided context name that the default payment method should be deleted for.

id
required
string <uuid>

The unique identifier of the customer record.

header Parameters
Toast-Restaurant-External-ID
required
string

The identifier of the restaurant location.

Responses
200

Successful operation. Default payment method deleted.

404

The customer record does not exist, or no default payment method is set for the context name.

500

Internal server error.

delete/v1/customers/{id}/payment-methods/defaults/{contextName}
Request samples
curl -i -X DELETE \
  'https://toast-api-server/v1/customers/{id}/payment-methods/defaults/{contextName}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Toast-Restaurant-External-ID: string'
Response samples
application/json
{
  • "paymentMethodId": "b6df8625-cd25-4123-b345-638aa7b5d011",
  • "contextName": "string"
}