developer_guide:call_reference:eventrequest
Table of Contents
EventRequest Call Reference
EventRequest will trigger a specific event for a specific subscription.
View:
EventRequest
Overview
The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, scroll down to find it in the table below the box.
XML
<?xml version="1.0" encoding="utf-8"?> <EventRequest> <Username>string</Username> <Token>string</Token> <GUID>string</GUID> <Action>string</Action> </EventRequest>
Elements
Name | Type | Occurrence | Meaning |
---|---|---|---|
EventRequest | container | required | Parent Element |
Username | string | required | Merchant API username (this is not your SubscriptionBridge login id) |
Token | string | required | Your application's security token. view also: How to create a token |
GUID | string | required | This is the unique ID that was returned with your SubscriptionRequest |
Action | string | required | This is the action you want to trigger. |
Actions
The follow are the valid parameters for the “Action” element in the XML above:
- Trial_Ending_Reminder
- Trial_Ending_Reminder_Final
- Balance_Due
- Balance_Due_Final
- Subscription_Canceled
EventResponse
Overview
The box below lists all fields that could be included in the call response. To learn more about an individual field or its type, scroll down to find it in the table below the box.
XML
<?xml version="1.0" encoding="utf-8"?> <EventResponse> <Status>string</Status> <Timestamp>timestamp</Timestamp> </EventResponse>
Elements
Name | Type | Occurrence | Meaning |
---|---|---|---|
EventResponse | container | required | Parent Element |
Status | string | always | Success, Error, or Warning |
Timestamp | string | always | All responses return the official SB time stamp in UTC/GMT |
Packages | container | always | A container element that contains a list of repeating package elements |
developer_guide/call_reference/eventrequest.txt · Last modified: 2010/01/06 02:11 by matt