API Documentation

/tip
API operation used to send or request a tip.  Special permissions are required to access this endpoint.
Production:
Test:
https://tippingcircle.com/rest/v1/tip
http://test.tippingcircle.com/rest/v1/tip

Request
Remember to include the OAuth values in the Authorization Header to authenticate the request.
  Param Description
* tipType Possible values include: "send-tip", "request-tip"
* fromUserId Must be the authenticated user's unique id.
* pin Account PIN for verification purposes.  Must be exactly 4 digits.
toSocialConnectionId The unique id for the social connection.  Provided in the /circle or the /getUser responses.
email The email address of the receiver IF the social connection doesn't already have one.  The email and receiverName are required IF the request is creating a new social connection.
receiverName The receiver's name.  Only required IF the toSocialConnectionId is not provided.
* amount The tip amount.  Must be at least $1 and cannot exceed $2,000.  For personal tips, the amount cannot exceed $1,000.
message A friendly message or memo about the tip.  (Max Length: 140 characters)
* isPersonalTip Boolean: specify if is a personal tip.
* addTheFee Boolean: if true, then the server will estimate the PayPal fee and add it to the amount.
* enableAutoReminders Boolean: for tip requests only.  If true, then the server will send out periodic reminders to the receiver.   Learn more about automatic reminders.
tippingBucketId The unique id for a tipping bucket.  Used for bucket tips only.
POST /tip

Header
Content-Type: 'application/json'
Authorization: OAuth realm="",
oauth_consumer_key="E4ZcTipHc3CozLB3jknSTK2et",
oauth_nonce="dn5st4g",
oauth_signature="gtj49bsnzb6lw6h73tp3g72o81",
oauth_signature_method="HMAC-SHA1",
oauth_timestamp="1366151475",
oauth_version="1.0"

Body
{
"addTheFee": false,
"amount": 10.50,
"email": null,
"enableAutoReminders": true,
"fromUserId": 123456,
"isPersonalTip": true,
"message": "Thanks for covering for me last night.",
"pin": "9856",
"receiverName": null,
"tippingBucketId": null,
"tipType": "send-tip",
"toSocialConnectionId": 75807
}

Response
{
"success": true
"errorCode": 0,
"message": "String content",
}