Payment Callback

Register your Payment Callback URL and get Payment status

Method and URL

POST www.yourcompany.com/payment_callback_url

Request

Header Request

Parameter	Data Type	Requirement	Description
X-API-Key	String	M	Callback API Key, an additional API Key used specifically for receiving callbacks
Content-Type	String	M	application/JSON
Accept	String	M	application/JSON

Request Body

{
  "event": "PAYMENT.PAID",
  "data": {
    "id": "bca0b57a-391e-4f6f-bfef-8cd37492ee5b",
    "clientReferenceId": "1750758552",
    "amount": {
      "value": 10001,
      "currency": "IDR"
    },
    "autoConfirm": true,
    "mode": "REDIRECT",
    "redirectUrl": {
      "successReturnUrl": "https://merchant.com/success",
      "failureReturnUrl": "https://merchant.com/failed",
      "expirationReturnUrl": "https://merchant.com/expired"
    },
    "paymentType": "SINGLE",
    "paymentMethod": {
      "type": "CARD"
    },
    "statementDescriptor": "Reforza Pivot",
    "saveForFutureUse": false,
    "showSavedPayment": false,
    "status": "PAID",
    "investigationStatus": null,
    "createdAt": "2025-06-24T09:49:13Z",
    "updatedAt": "2025-06-24T09:56:40.020691396Z",
    "expiryAt": "2025-12-30T23:59:00Z",
    "paymentUrl": "https://pay-stg.pivot-payment.com/detail?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1dWlkIjoiYmNhMGI1N2EtMzkxZS00ZjZmLWJmZWYtOGNkMzc0OTJlZTViIiwiaXNzIjoiYmFja2VuZC1wb3J0YWwiLCJleHAiOjE3NjcxMzkxNDB9.yvVXKEgcbJucCACggQLaFZQmnqkzvDAfK56kcNY625o",
    "chargeDetails": [
      {
        "id": "cf2842f4-e263-4643-8bc9-af682a5060cd",
        "paymentSessionId": "bca0b57a-391e-4f6f-bfef-8cd37492ee5b",
        "paymentSessionClientReferenceId": "1750758552",
        "amount": {
          "value": 10001,
          "currency": "IDR"
        },
        "statementDescriptor": "Reforza Pivot",
        "status": "SUCCESS",
        "authorizedAmount": {
          "value": 10001,
          "currency": "IDR"
        },
        "capturedAmount": {
          "value": 10001,
          "currency": "IDR"
        },
        "isCaptured": true,
        "createdAt": "2025-06-24T09:49:12.861006Z",
        "updatedAt": "2025-06-24T09:56:40.020691Z",
        "paidAt": "2025-06-24T09:56:39Z",
        "fdsRiskAssessment": {
          "score": "0",
          "level": "very low",
          "recommendation": "Approve",
          "status": "PASSED",
          "evaluatedAt": "2025-06-24T09:56:39Z"
        },
        "card": {
          "first6": "444000",
          "first8": "44400001",
          "last4": "0002",
          "expMonth": "01",
          "expYear": "39",
          "binInformations": {
            "type": "DEBIT",
            "issuingBank": "UNKNOWN",
            "brand": "VISA",
            "country": "ID"
          },
          "authenticationResult": {
            "threeDsVersion": "2.2.0",
            "threeDsResult": "AUTHENTICATION_SUCCESSFUL",
            "threeDsMethod": "",
            "eciCode": "00"
          },
          "authorizationResult": {
            "acquirerReferenceNumber": "123456789",
            "retrievalReferenceNumber": "TRXCCfd7d4b1877e117696670881",
            "stan": "104539",
            "avsResult": "",
            "cvvResult": "",
            "authorizedAmount": {
              "value": 100000,
              "currency": "IDR"
            },
            "issuerAuthorizationCode": "00"
          }
        },
        "captureHistories": null
      }
    ],
    "customerId": "0197e3f5-1a17-7d43-b2f9-1b51479fb8a9",
    "customer": {
      "givenName": "Reforza Jordan",
      "surname": "Geotama",
      "email": "[e-mail]",
      "phoneNumber": {
        "countryCode": "+62",
        "number": "89699990003"
      },
      "refundPreference": {
        "method": "AUTO",
        "transferDestination": {
          "channelCode": "014",
          "channelInformation": {
            "accountNumber": "17677665415",
            "accountName": "Reforza Jordan Geotama"
          }
        }
      },
      "storePaymentMethods": null
    },
    "metadata": {
      "invoiceNo": "INV001"
    },
    "bypassStatusPage": false
  }
}

Detail Parameter Request

Parameter	Data Type	Requirement	Description
event	String	M	List of Event Names: PAYMENT.PROCESSING PAYMENT.PAID CHARGE.SUCCESS PAYMENT.CANCELLED Explanation: PAYMENT.PAID will be sent once the Customer successfully charges the Payment with the Payment Type = SINGLE CHARGE.SUCCESS will be sent once the Customer successfully charges the Payment with the Payment Type = MULTIPLE
Payment Session	Object	M	Payment Session Object