Idempotency

Attach this Parameter on the Header Request whenever you Create a Payment or Payout

Parameter
Data Type
Required
Description

X-REQUEST-ID

String

YES

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

Scenario

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

  2. Second-time request 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 Create Payment / Payout using the same X-REQUEST-ID: 123 with the same request Payload, then Pivot will return Response HTTP Status 200, with same initial response

Requirements

The requirement for X-REQUEST-ID are:

  1. Allow only alphanumeric characters

  2. Minimum length is 16 digit

  3. Maximum length is 36 digit

  4. Expired in 24 hours, means after 24 hours you can reuse the same x-request-id for another transaction request

Last updated