Payment Methods
A payment method represents transactable payment information such as credit card details or a customer's authorization to charge a PayPal or Venmo account. Payment methods belong to a customer, are securely stored in the Braintree Vault, and have a payment_method_token attribute that you can store on your servers with reduced PCI compliance burden and later use to create transactions.
Create
Use Payment Method: Create to create a payment method for an existing customer using a payment method single-object token received from the client :
- Python
result = gateway.payment_method.create({
"customer_id": "12345",
"payment_method_nonce": nonce_from_the_client
})
Alternatively, you can create a new customer with a payment method using Customer: Create with the payment_method_nonce parameter.
After the payment method is successfully created, you can use Transaction: Sale with the payment_method_token parameter to create a transaction.
Update
Use Payment Method: Update to update an existing payment method.
Make default
Use the make_default option to set a payment method as the default for its customer:
- Python
result = gateway.payment_method.update("the_token", {
"options": {
"make_default": True
}
})
Billing address
Update the billing address:
- Python
result = gateway.payment_method.update("the_token", {
"billing_address": {
"street_address": "100 Maple Lane",
"options": {
"update_existing": True
}
}
})
You can also omit the update_existing option to create a new billing address for the payment method.
See the reference and more examples of updating a payment method . If you want to update both payment method and customer information together, use Customer: Update.
Find
Use Payment Method: Find to find a payment method:
- Python
payment_method = gateway.payment_method.find("token")
The return value of the Payment Method: Find call will be a payment_method response object.
Delete
Use Payment Method: Delete to delete a payment method:
- Python
result = gateway.payment_method.delete("the_token")
result.is_success
# True