Retrieve payment plan
Use this method to retrieve information about a payment plan.
To retrieve a payment plan, you need its paymentPlanId. Our gateway returned the paymentPlanId in the response of the Create Payment Plan method.
Note: If you don’t have the paymentPlanId, use our List Payment Plans method to search for the payment plan.
Our gateway returns the following information about the payment plan:
- Name, length, and currency of the plan
- How often our gateway collects each payment
- How much our gateway collects for each payment
- What happens if the merchant updates or deletes the plan
Path parameters
Headers
Bearer authentication of the form Bearer <token>, where token is your auth token.
Response
Indicates how the merchant takes the payment from the customer’s account.
manual
- The merchant manually collects payments from the customer.automatic
- The terminal automatically collects payments from the customer.
Indicates whether any changes that the merchant makes to the payment plan apply to existing subscriptions.
update
- Changes apply to existing subscriptions.continue
- Changes don’t apply to existing subscriptions.
Indicates what happens to existing subscriptions if the merchant deletes the payment plan.
complete
- Stops existing subscriptions.continue
- Continues existing subscriptions.
Object that contains information about the cost of each payment.
Note: Send this object only if the value for type is automatic
.
Number of payments for the payment plan.
To indicate that the payment plan should run indefinitely, send a value of 0
.