New Optional Feature: Payer Details Information in Callback for Khipu Payments

New Optional Feature: Payer Details Information in Callback

Effective Date: Now Status: Optional

Overview

We are pleased to announce a new optional feature for Khipu Payment Methods. This feature allows merchants to receive detailed payer information in the callback when a transactionis Approved. With this enhancement, merchants can handle payouts more effectively, improving both transaction management and record-keeping, allowing you to send refunds/payouts without the need to request the information from the customer.

How It Works

Once activated, this feature will include the following payer details as an object in the callback data for Approved transactions:

"payer": {
        "payerName": "John Doe",
        "name": "John Doe",
        "lastName": null,
        "personalId": "12.345.678-9",
        "payoutAccountTypeCode": null,
        "accountused": "1234567890",
        "accountNumber": "1234567890",
        "accountAgencyNumber": null,
        "bankTrackingID": "Banco de Chile (Edwards Citi)",
        "bankName": "Banco de Chile (Edwards Citi)",
        "maskCardNumber": null
      }

Activation

To enable this feature for your shop, please reach out to our Integrations Team at [email protected]. Our team will assist you in activating this feature and answer any questions you may have.

Callback Response Example

Once activated, the callback response for an approved transaction will include an additional field as shown below:

{
  "EventCode": "NOTIFICATION_LOG",
  "Message": "Notification AT: 10/01/2025 16:22:22 For Tx: 3a399b4c-5cd6-415e-bd2f-632fcca38ba9",
  "Payload": {
    "TrackingId": "3a399b4c-5cd6-415e-bd2f-632fcca38ba9",
    "MerchantId": null,
    "ShopId": null,
    "ShopName": null,
    "StatusTypeCode": "APPROVED",
    "NetworkOperationRequestUri": "https://payr-tests.free.beeceptor.com/public/payments/webhook",
    "NetworkOperationRequestMethod": "POST",
    "NetworkOperationRequestBody": {
      "uid": "3a399b4c-5cd6-415e-bd2f-632fcca38ba9",
      "type": "payment",
      "status": "APPROVED",
      "message": null,
      "trackingId": "2024080457",
      "amount": 78,
      "currency": "USD",
      "amountChanged": false,
      "originalAmount": 0,
      "newCouponAmount": null,
      "newCouponCurrency": null,
      "description": "Test Khipu payer data",
      "cardNumber": null,
      "createdAt": "2025-10-01T16:15:52.9423852Z",
      "updatedAt": "2025-10-01T16:15:52.9423852Z",
      "customer": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "[email protected]",
        "country": "CL",
        "city": null,
        "zip": "",
        "address": null,
        "phone": null,
        "deviceId": "",
        "ip": null,
        "personalId": "12345678"
      },
      "billing": {
        "currency": "CLP",
        "amount": 80000
      },
      "paymentMethod": {
        "id": "9fb3168a-57e6-4f44-b7e7-f40adc7c6a0b",
        "name": "Khipu",
        "type": "Online"
      },
      "payer": {
        "payerName": "John Doe",
        "name": "John Doe",
        "lastName": null,
        "personalId": "12.345.678-9",
        "payoutAccountTypeCode": null,
        "accountused": "123456789",
        "accountNumber": "123456789",
        "accountAgencyNumber": null,
        "bankTrackingID": "Banco de Chile (Edwards Citi)",
        "bankName": "Banco de Chile (Edwards Citi)",
        "maskCardNumber": null
      }
    },
    "NetworkOperationStatus": 200,
    "NetworkOperationResponseBody": "Hey ya! Great to see you here. Btw, nothing is configured for this request path. Create a rule and start building a mock API.",
    "NetworkOperationResponseRawBody": null,
    "NetworkOperationResponseContentType": null
  },
  "TrackingId": "3a399b4c-5cd6-415e-bd2f-632fcca38ba9",
  "PayloadIsModel": true,
  "IndexType": "payment",
  "PartnerId": 0,
  "PayoutId": 0,
  "PayoutBatchId": 0,
  "PayoutProcessorId": 0
}

This feature aims to enhance data transparency for merchants, giving you greater control and access to important transaction details and allowing you to send refunds/payouts without the need to request the information from the customer.

For further questions, feel free to reach out to our team