{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml","api-docs-apis/openapi.yaml":"api-docs-apis/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["replay-openapi"]},"type":"markdown"},"seo":{"title":"ParadisePay Docs","description":"ParadisePay is the groundbreaking payment gateway that lets you integrate with the future of payments."},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"add-a-tip","__idx":0},"children":["Add a tip"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tip"]}," records how much of a transaction is gratuity. Card networks want that split reported separately, and some industry categories price differently because of it, so it is worth sending rather than folding silently into the total."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-one-rule-that-matters","__idx":1},"children":["The one rule that matters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," is the whole charge. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tip"]}," says how much of it is a tip."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The two are not added together. A 100.00 meal with a 20.00 tip is:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"amount\": 12000,\n  \"tip\": 2000\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The cardholder is charged 120.00. Sending ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"amount\": 10000, \"tip\": 2000"]}," charges them 100.00 and reports 20.00 of it as gratuity, which is not what you meant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both fields are integers in cents. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tip"]}," accepts ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},", and omitting it means the same thing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"on-a-sale","__idx":2},"children":["On a sale"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send both fields with the transaction."]},{"$$mdtype":"Tag","name":"ReplayOpenApi","attributes":{"descriptionFile":"api-docs-apis/openapi.yaml","operationId":"createTransaction","exampleKey":"saleWithTip","parameters":{},"options":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"on-a-capture","__idx":3},"children":["On a capture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the more common shape in hospitality: authorize the bill, let the customer add a tip, capture the total."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Authorize the base amount first, then send the total and the tip together at capture."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"amount\": 12000,\n  \"tip\": 2000\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two things to get right:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The capture ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," includes the tip."]}," It is the total you are taking, the same rule as on a sale."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You cannot capture more than you authorized."]}," A tip that pushes the total above the authorization will not go through. Authorize with enough headroom for the tip you expect — the usual practice is to add a percentage to the bill when you authorize."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/authorize-and-capture"},"children":["Authorize and capture"]}," covers the rest of that flow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reading-it-back","__idx":4},"children":["Reading it back"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response echoes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tip"]}," alongside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},", on the transaction and on every later read of it. The settled amount is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},"; the tip is reported to the card network separately and does not add to it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":5},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/record-tax"},"children":["Record tax"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/authorize-and-capture"},"children":["Authorize and capture"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/accept-a-card-payment"},"children":["Accept a card payment"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/after-the-payment/find-and-report-on-transactions"},"children":["Find and report on transactions"]}]}]}]},"headings":[{"value":"Add a tip","id":"add-a-tip","depth":1},{"value":"The one rule that matters","id":"the-one-rule-that-matters","depth":2},{"value":"On a sale","id":"on-a-sale","depth":2},{"value":"On a capture","id":"on-a-capture","depth":2},{"value":"Reading it back","id":"reading-it-back","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Add a tip","shortTitle":"Add a tip","intro":"Declare how much of a charge is gratuity, either when you take the payment or when you capture an authorization.","type":"how-to","seo":{"title":""}},"lastModified":"2026-10-22T22:42:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/payments/add-a-tip","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}