Ctrlk
Get StartedAccount and Balance ManagementPaymentsPayoutsAPI References
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Idempotency

Attach this Parameter to the Header Request whenever you create a Payment or Payout

Parameter
Data Type
Requirement
Description

X-REQUEST-ID

String

M

Unique Idempotency Key to make sure no double transaction created from Merchant

Scenario

  1. First-time request to create Payment / Payout using the X-REQUEST-ID : 123, a successful process will return a Response HTTP Status 200

  2. Second-time request to create Payment / Payout using the same X-REQUEST-ID : 123 With a different Payload, then Pivot will return HTTP Response 409

  3. Second-time request to create Payment / Payout using the same X-REQUEST-ID : 123 With the same request Payload, then Pivot will return a HTTP Response Status 200, with the same initial response

Requirements

The requirement for X-REQUEST-ID are:

  1. Allow only alphanumeric characters

  2. Minimum length is 16 digits

  3. Maximum length is 36 digits

  4. Expired in 24 hours, which means after 24 hours, you can reuse the same X-REQUEST-ID for another transaction request

PreviousAuthenticationNextPagination

Last updated