Skip to main content

Documentation

Customer Payment Method

Describes a payment method that has been saved to a customer profile.

You can add a payment method to a customer profile, as well as update and manage a customer's payment methods.

Add Payment Method Message Sequences

These sequences describe the process of adding a payment method to a customer.

Notes

PCI Compliance certification is required for collection of customer personal identifying information (PII) for cards. If you do not have PCI certification, use Create Card Token.

When you add a payment method to a customer, it does not become the default payment method. See Update Customer.

Most Non-Card Payment Methods

This sequence describes the process when a client adds most non-card payment methods to a customer.

  1. The client sends an Add Payment Method to Customer request to Rapyd.

  2. Rapyd completes the operation and sends a response.

  3. Rapyd sends Webhook - Customer Payment Method Created.

Card Payment Method without 3DS

This sequence describes the process when a client adds a card payment method to a customer without 3DS authentication.

  1. The client sends an Add Payment Method to Customer request to Rapyd.

  2. Rapyd completes the operation and sends a response.

  3. Rapyd sends Webhook - Customer Payment Method Created.

  4. Rapyd sends Webhook - Payment Succeeded for a zero-amount transaction.

  5. Rapyd sends Webhook - Card Added Successfully.

Card Payment Method with 3DS

This sequence describes the process when a client adds a card payment method to a customer with 3DS authentication.

  1. The client sends an Add Payment Method to Customer request to Rapyd.

  2. Rapyd completes the operation and sends a response with redirect URL for 3DS verification.

  3. Rapyd sends Webhook - Customer Payment Method Created.

  4. The client sends the redirect URL to the customer.

  5. The customer completes 3DS verification.

  6. The 3DS authentication server notifies Rapyd that the customer is authenticated.

  7. Rapyd sends Payment Updated Webhook for a zero-amount transaction.

  8. Rapyd sends Webhook - Card Added Successfully.

SEPA Bank Transfer Payment Method

This sequence describes the process when a client adds a bank transfer payment method to a customer in the Single Euro Payments Area (SEPA).

  1. The client sends an Add Payment Method to Customer request. The payment method is a SEPA bank transfer.

  2. Rapyd sends a response to the Add Payment Method to Customer request.

  3. Rapyd sends Webhook - Customer Payment Method Created.

  4. Rapyd requests a mandate ID from the bank.

  5. The bank requests a customer signature.

  6. The customer signs the mandate.

  7. The bank sends the mandate ID to Rapyd.

  8. Rapyd sends Customer Payment Method Updated webhook.