Retrieve all payment methods of a customer
Retrieve all the payment methods for a specific customer.
This can be useful in the following example cases:
- To show what information is stored for the customer.
- To try a different payment method if the first payment method fails when a recurring transaction occurs.
Request
The ID of the Customer object.
If only_merchant is set to true, you retrieve the payment methods
that were saved for the merchant (saved_for: "MERCHANT").
To use this parameter insert it at the end of the request URL. See this example for a request URL in Production environment:
https://merchant.revolut.com/api/1.0/customers/{customer_id}/payment-methods?only_merchant=true
Example: "Bearer sk_1234567890ABCdefGHIjklMNOpqrSTUvwxYZ_1234567890-Ab_cdeFGHijkLMNopq"
This parameter accepts the Merchant API Secret key to authorise requests coming from the merchant's backend.
It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a Bearer token.
For more information, see: Authentication
Response
OK
The ID of the payment method.
Possible values: [CARD, REVOLUT_PAY]
The type of the payment method.
Only merchant initiated transactions are supported for saved REVOLUT_PAY payment methods.
Possible values: [CUSTOMER, MERCHANT]
Indicates in which case this saved payment method can be used for payments.
CUSTOMER: This payment method can be used only when the customer is on the checkout page.MERCHANT: This payment method can be used without the customer being on the checkout page, and the merchant can initiate transactions, for example, to take payments for recurring transactions.
The details of the payment method.
Possible length: >= 6 characters and <= 6 characters
The BIN of the payment card.
Possible length: >= 4 characters and <= 4 characters
The last four digits of the payment card.
The expiry month of the payment card.
The expiry year of the payment card.
The name of the cardholder.
The billing address of the payment method.
Possible length: non-empty
Street line 1 information.
Possible length: non-empty
Street line 2 information.
Possible length: non-empty
The postcode associated with the address.
Possible length: non-empty
The city associated with the address.
Possible length: non-empty
The region associated with the address.
Possible length: non-empty
The country associated with the address.
Possible values: [VISA, MASTERCARD, MAESTRO]
The brand of the payment card.
Possible values: [DEBIT, CREDIT, PREPAID, DEFERRED_DEBIT, CHARGE]
The funding type of the payment card.
The issuer of the payment card.
Two-letter country code of the country where the payment card was issued.
The date and time the payment card was added.