---
title: "Payin updated"
method: POST
path: "payin.updated"
tags: ["Webhooks"]
---

# Payin updated

`POST payin.updated` (webhook)

Sent when a payin changes status (`AWAITING` → `COMPLETED`, `ERROR`, `EXPIRED`, etc.). Set the destination URL using `callbackUrl` when creating the payment. The body is identical to the [Get Payment](https://docs.infiniaweb.com/reference/v1_get_payment__id___get) response.

## Payload

- PaymentResponse
  - `id` string, required — Payment ID
  - `market` 'GB' | 'EU' | 'US' | 'BR' | 'UY' | 'MX' | 'PY' | 'PE' | 'CL' | 'AR' | 'CO', required
  - `type` 'OFFLINE' | 'ONLINE' | 'PIX_ITP' | 'PLEXO' | 'ONLINE' | 'PIX' | 'CODI' | 'SPEI' | 'OFFLINE' | 'OFFLINE' | 'OFFLINE' | 'OFFLINE' | 'OFFLINE' | 'PULL' | 'CRYPTO' | 'OFFLINE_SERVICE_PAYMENT' | 'PULL' | 'PULL' | 'ONLINE', required
  - `amount` number, required — Amount of the payment
  - `currency` 'GBP' | 'EUR' | 'USD' | 'BRL' | 'UYU' | 'USD' | 'MXN' | 'PYG' | 'PEN' | 'CLP' | 'ARS' | 'USD' | 'BRLA' | 'COP', required
  - `status` 'AWAITING' | 'EXPIRED' | 'COMPLETED' | 'PARTIALLY_REFUNDED' | 'REFUNDED' | 'ERROR'
  - `retryable` boolean — Specifies if the payment can be retried (applicable only to rails that support retries)
  - `expiryDate` string, date-time — Payment expiration date in UTC (ISO 8601 format)
  - `callbackUrl` string — Specifies the URL to which the callback will be sent when the transaction status changes. The callback is sent as a POST request with a JSON body containing the transaction details, using the same schema as the Get Payment endpoint.
  - `redirectUrl` string — Specifies the URL to which the user will be redirected after the payment is completed (only applicable if using Infinia's Widget)
  - `startUrl` string — URL to start the payment flow through Infinia's widget
  - `reference` string — Reference for the payment. If the payment rail supports references, it will be shown to the payer.
  - `account` Account
    - `id` string — ID of the collection account
    - `country` string, required — Country of collection account (ISO 3166-1 alpha-2 format)
    - `bank` string, required — Bank of collection account
    - `currency` string, required — Currency of collection account
    - `number` string, required — Account number of collection account
  - `accountId` string — Account ID
  - `providerExternalId` string — Provider ID
  - `createdAt` string, date-time, required — Creation date of the payment (ISO 8601 format)
  - `updatedAt` string, date-time, required — Last update date of the payment (ISO 8601 format)
  - `initData` union — Data sended to create payment
    - string
    - object
  - `payerData` PayerData
    - `name` string — Payer name
    - `documentNumber` string
    - `documentType` string — Payer document type
    - `bankCode` string — Payer bank code
    - `bankName` string — Payer bank name
    - `accountNumber` string — Payer account number
  - `voucherId` string — Voucher ID for the payment
  - `attempts` PaymentAttemptResponse[], required — List of payment attempts
    - `createdAt` string, date-time, required — Creation date of the payment attempt (ISO 8601 format)
    - `updatedAt` string, date-time, required — Last update date of the payment attempt (ISO 8601 format)
    - `providerExternalId` string — Provider extenral id 1
    - `providerExternalId2` string — Provider extenral id 2
    - `payerData` PayerData
      - `name` string — Payer name
      - `documentNumber` string
      - `documentType` string — Payer document type
      - `bankCode` string — Payer bank code
      - `bankName` string — Payer bank name
      - `accountNumber` string — Payer account number
    - `status` 'AWAITING' | 'EXPIRED' | 'COMPLETED' | 'PARTIALLY_REFUNDED' | 'REFUNDED' | 'ERROR', required
  - `refunds` SimplifiedRefundResponse[] — List of refunds
    - `id` string, required — Refund ID
    - `created_at` string, date-time, required — Creation date of the refund
    - `updated_at` string, date-time — Last update date of the refund
    - `idempotency_key` string — Idempotency key for the refund request, it can also be used as an external identifier
    - `status` 'PENDING' | 'SUCCESS' | 'FAILED', required — Status of the refund
  - `company` Company, required
    - `id` integer, required
    - `name` string, required

## Acknowledgement `200`

Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses.

---

[API](https://skmtc.net/infiniaweb/apis/payins.md) · [All operations](https://skmtc.net/infiniaweb/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infiniaweb/payins/revisions/3f453785c478/schema)