Sign in

v1

latestOpenAPI 3.1.02026-07-2432337285.3 KB
Webhooks

Payin updated

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 response.

postWebhookpayin.updated

Payload

idstring 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
amountnumber 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'
retryableboolean

Specifies if the payment can be retried (applicable only to rails that support retries)

expiryDatestring date-time

Payment expiration date in UTC (ISO 8601 format)

callbackUrlstring

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.

redirectUrlstring

Specifies the URL to which the user will be redirected after the payment is completed (only applicable if using Infinia's Widget)

startUrlstring

URL to start the payment flow through Infinia's widget

referencestring

Reference for the payment. If the payment rail supports references, it will be shown to the payer.

accountIdstring

Account ID

providerExternalIdstring

Provider ID

createdAtstring date-time required

Creation date of the payment (ISO 8601 format)

updatedAtstring date-time required

Last update date of the payment (ISO 8601 format)

voucherIdstring

Voucher ID for the payment

Response

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