CreateVaPaymentRequest

paymentHubIdintegerrequired

Example: 123

amountnumber<decimal>nullable

Example: 125000

currencystringrequired

Possible values: [ARS]

Example: ARS

lockModestringrequired

Possible values: [time, amount, amount_and_time]

Example: amount_and_time

ttlSecondsinteger

Possible values: <= 28800

Example: 1800

clientIdstring<uuid>nullable

Example: 4f0de7f2-7cd9-4ea2-bb82-f3118ddbe940

clientTaxIdstringnullable

Example: 30712345678

clientNamestringnullable

Example: Acme SA

callbackUrlstring<uri>nullable

Webhook URL that receives every VA payment event. Cannot be combined with successUrl or failureUrl. The URL must use https.

Example: https://merchant.example/webhooks/basilic

successUrlstring<uri>nullable

Webhook URL that receives the success events. Send it together with failureUrl. Cannot be combined with callbackUrl. The URL must use https.

Example: https://merchant.example/payments/success

failureUrlstring<uri>nullable

Webhook URL that receives the failure events. Send it together with successUrl. Cannot be combined with callbackUrl. The URL must use https.

Example: https://merchant.example/payments/failure

externalReferencestringnullable

Example: order-123

metadata object

property name*any

Example: {"orderId":"order-123"}

CreateVaPaymentRequest

{
  "paymentHubId": 123,
  "amount": 125000,
  "currency": "ARS",
  "lockMode": "amount_and_time",
  "ttlSeconds": 1800,
  "clientId": "4f0de7f2-7cd9-4ea2-bb82-f3118ddbe940",
  "clientTaxId": "30712345678",
  "clientName": "Acme SA",
  "callbackUrl": "https://merchant.example/webhooks/basilic",
  "successUrl": "https://merchant.example/payments/success",
  "failureUrl": "https://merchant.example/payments/failure",
  "externalReference": "order-123",
  "metadata": {
    "orderId": "order-123"
  }
}