Callback

Get notified when there is an update for transactions

Callback allows you to receive a notification when a minting or redemption transaction is completed. To use Callback, you must first generate an API Key. Once you have your API Key, navigate to the API Key menu and select the Callback URL tab to set it up.

Enter your Mint and Redeem Callback URLs. You may use a single endpoint for both callbacks if preferred. Once done, click the Save Callback URL button to confirm.

You’ll see a notification in the bottom-right corner once the Callback URL is successfully saved.

You can then use the endpoint to receive callbacks in your logs whenever there’s an update to your mint or redeem transactions. Please refer to the example below.

Example Responses

Mint

IDRX

{
  id: 1234,
  paymentAmount: 91244,
  merchantOrderId: '20250731051439',
  productDetails: 'Minting IDRX',
  toBeMinted: '91244',
  destinationWalletAddress: '0xabcdefgh',
  chainId: 56,
  merchantUserInfo: 1234,
  customerVaName: 'NUR MUHAMMAD LUTHFI',
  email: '[email protected]',
  virtualAccountNo: null,
  vaPaymentRequestId: null,
  minted: false,
  paymentStatus: 'PAID',
  userMintStatus: 'MINTED',
  adminMintStatus: 'MINTED',
  deleted: false,
  createdAt: '2025-07-31T05:14:39.836Z',
  updatedAt: '2025-07-31T05:17:32.691Z',
  expiryTimestamp: '1754025279834',
  isApproved: false,
  reference: 'ABC1234EFGH',
  txHash: '0x1234abcdefgh',
  qredoTxId: null,
  signedTx: null,
  reportStatus: 'NONE',
  requestType: null,
  processByUserId: 1234,
  usdtRequest: null,
  TransactionHistory: {
    id: 1234,
    merchantCode: '1234ABC',
    amount: '91244',
    merchantOrderId: '123456789',
    productDetail: 'Minting IDRX',
    additionalParam: 'toBeMinted: 91244 destinationWalletAddress: 0x1234ABCD',
    resultCode: '00',
    signature: '123456789',
    paymentCode: 'NQ',
    merchantUserId: 1234,
    reference: null,
    spUserHash: null,
    settlementDate: '2025-08-02',
    publisherOrderId: 'ABC12345',
    sourceAccount: null,
    deleted: false,
    createdAt: '2025-07-31T05:14:51.313Z',
    updatedAt: '2025-07-31T05:14:51.313Z'
  },
  MintRequestTransactionFees: []
}

USDT/USDC/USDT0

{
  id: 1234,
  paymentAmount: 93141,
  merchantOrderId: '20250731050311',
  productDetails: 'Minting IDRX',
  toBeMinted: '93141',
  destinationWalletAddress: '0xabcdefgh',
  chainId: 1135,
  merchantUserInfo: 1234,
  customerVaName: 'NUR MUHAMMAD LUTHFI',
  email: '[email protected]',
  virtualAccountNo: null,
  vaPaymentRequestId: null,
  minted: false,
  paymentStatus: 'PAID',
  userMintStatus: 'MINTED',
  adminMintStatus: 'MINTED',
  deleted: false,
  createdAt: '2025-07-31T05:03:11.198Z',
  updatedAt: '2025-07-31T05:03:45.605Z',
  expiryTimestamp: '1754024591196',
  isApproved: false,
  reference: 'ABC123XYZC6789',
  txHash: '0xabcdefghijk',
  qredoTxId: null,
  signedTx: null,
  reportStatus: 'NONE',
  requestType: 'usdt',
  processByUserId: 1234,
  usdtRequest: {
    id: 1234,
    mintRequestId: 1234,
    merchantOrderId: '20250731050311',
    destinationWalletAddress: '0xabcdefgkhj',
    chainId: 1135,
    amountIdrx: 93141,
    usdtRequested: '5.6413',
    amountUsdt: '5.641281',
    swapTxHash: '0xabcdefghj',
    txHash: '0xabcdefgh',
    status: 'SUCCESS',
    deleted: false,
    createdAt: '2025-07-31T05:03:11.205Z',
    updatedAt: '2025-07-31T05:04:14.835Z'
  },
  TransactionHistory: {
    id: 1234,
    merchantCode: 'ABC123',
    amount: '93141',
    merchantOrderId: '123456789',
    productDetail: 'Minting IDRX',
    additionalParam: 'toBeMinted: 93141 destinationWalletAddress: 0xabcdefghjikl',
    resultCode: '00',
    signature: '123abc',
    paymentCode: 'NQ',
    merchantUserId: 1234,
    reference: null,
    spUserHash: null,
    settlementDate: '2025-08-02',
    publisherOrderId: 'ABC123XYZ678',
    sourceAccount: null,
    deleted: false,
    createdAt: '2025-07-31T05:03:23.201Z',
    updatedAt: '2025-07-31T05:03:23.201Z'
  },
  MintRequestTransactionFees: []
}

Redeem

IDRX

{
  id: 1234,
  chainId: 56,
  userId: 1234,
  requester: 'NUR MUHAMMAD LUTHFI',
  txHash: '0xabcdefghijk',
  fromAddress: '0xlmnopqrstuvwxyz',
  amount: '15000',
  bankName: 'BANK JAGO',
  bankCode: '542',
  bankAccountNumber: '123456789',
  bankAccountName: 'NUR MUHAMMAD LUTHFI',
  bankAccountNumberHash: null,
  custRefNumber: '123456789',
  disburseId: 123456789,
  burnStatus: 'SUCCESS',
  createdAt: '2025-07-29T10:48:50.417Z',
  updatedAt: '2025-07-29T10:49:54.691Z',
  deleted: false,
  reportStatus: 'NONE',
  notes: ' | ',
  RedeemRequestTransactionFees: [
    {
      id: 1234,
      name: 'Payment Gateway Fee',
      amount: '5000',
      redeemRequestId: 3456,
      deleted: false
    }
  ]
}

USDT/USDC/USDT0

{
  id: 4593,
  chainId: 1135,
  userId: 2255,
  requester: 'NUR MUHAMMAD LUTHFI',
  txHash: '0x8359c8901667923ee0d214fd5100e0b99daea63d5acda2de276cff584461f16c',
  fromAddress: '0x55360Fe4179936e88c321f6e3bd23Ef34E916110',
  amount: '36219',
  bankName: 'GOPAY',
  bankCode: '1011',
  bankAccountNumber: '08123456789',
  bankAccountName: 'GOPAY Nxx Mxxxxxxx Lxxxxx',
  bankAccountNumberHash: null,
  custRefNumber: '000045642625',
  disburseId: 30098713,
  burnStatus: 'SUCCESS',
  createdAt: '2025-08-01T06:50:53.109Z',
  updatedAt: '2025-08-01T06:51:52.473Z',
  deleted: false,
  reportStatus: 'NONE',
  notes: null,
  RedeemRequestTransactionFees: [
    {
      id: 3217,
      name: 'Payment Gateway Fee',
      amount: '5000',
      redeemRequestId: 5943,
      deleted: false
    }
  ],
  depositRedeemRequest: {
    id: 208,
    chainId: 1135,
    userId: 2255,
    address: '0x1095bBe769fDab716A823d0f7149CAD713d20A13',
    toAddress: '0x55360Fe4179936e88c321f6e3bd23Ef34E916110',
    transferTxHash: '0x3e36838c61f3c9f2009d71b1b53dafc1d8eb280bf490e58ab08dee9767dcc842',
    tokenFrom: 'usdt',
    amountFrom: '2.511252',
    tokenTo: 'idrx',
    amountTo: '41219',
    swapTxHash: '0x15187b051f8f6b9da02470cf548f395199429442c445a52ebee44698fad9de93',
    burnTxHash: '0x8359c8901667923ee0d214fd5100e0b99daea63d5acda2de276cff584461f16c',
    status: 'SUCCESS',
    createdAt: '2025-08-01T06:49:06.406Z',
    updatedAt: '2025-08-01T06:50:53.118Z',
    deleted: false
  }
}