Action: Get recurring payment subscription details
This will allow you to retrieve the information related to a particular recurring payment subscription in Kartra.
Type | Parameters | Values |
POST | cmd* | get_subscription_details |
POST | subscription_id* | integer |
* Required fields
Here is an example:
'actions' => [ '0' => [ 'cmd' => 'get_subscription_details', 'subscription_id' => 993037 ] ]
Here are the results returned by the request:
Parameters | Values |
subscription_details | String (JSON encoded string containing the details of the recurring payment subscription) |
JSON parameters | Values |
subscription_id | integer A unique numeric identifier for the subscription id. |
subscription_product_id | integer Product id of the subscription. |
subscription_price_point | integer Product price point number of the subscription. |
subscription_lead_id | integer Id for the lead linked to the subscription. |
subscription_start_date | yyyy-mm-dd hh:mm:ss Subscription start date EST. |
subscription_end_date | yyyy-mm-dd hh:mm:ss Subscription end date EST (0000-00-00 00:00:00 if subscription is not cancelled or terminated). |
subscription_current_installment | integer Number of the current installment. |
subscription_installments_left | integer How many installments are left / string “Until cancelled” |
subscription_recurring_period | string (“monthly”, “every 2 months”, “quarterly”,”yearly”, “every 2 years”, “weekly”, “every 2 weeks”) The type of recurring for the subscription. |
subscription_status | string (“Active”, “Paused”, “Cancelled”, “Terminated”) Subscription status. |
subscription_next_payment_date | yyyy-mm-dd hh:mm:ss Subscription next payment date EST. |
subscription_next_scheduled_payment_amount | float The amount of the next scheduled payment. “N/A” if none. |
subscription_affiliate | string Username of the affiliate, “N/A” if none. |
subscription_jv | string Username of the jv, “N/A” if none. |
Example of the returned JSON array:
{ "get_subscription_details":{ "subscription_details":{ "subscription_id":"993037", "subscription_product_id":"213", "subscription_price_point":"2", "subscription_lead_id":"321", "subscription_start_date":"2021-01-07 11:14:00", "subscription_end_date":"0000-00-00 00:00:00", "subscription_current_installment":"1", "subscription_installments_left":"Until cancelled", "subscription_recurring_period":"monthly", "subscription_status":"Active", "subscription_next_payment_date":"2021-02-07 11:14:00", "subscription_next_scheduled_payment_amount":"22.19", "subscription_affiliate":"affiliate_username", "subscription_jv":"N/A" } } }
Error Cases:
Type Number | Message | Cause |
248 | Subscription doesn’t exist |
|
An example of an error message:
{ "status": "Error", "message": "Subscription doesn't exist", "type": 248 }