Pular para o conteúdo

Create recurring payment

Creates one automatic payment under an approved recurring consent. Use the consentId returned by Create recurring consent as recurringConsentId.

Ensure Get payment request shows consentStatus: AUTHORISED before calling this endpoint for the first payment after consent.

POST/api/v1/automatic-payments/recurring-payments

Create recurring payment

Creates a recurring payment with full payment details and returns the created automatic payment.

Auth: Bearer Token

Headers

1 campo
subTenantId●
headerstring

Subtenant initiating the payment.

Request body

10 campos
recurringConsentId●
bodystring

`consentId` from Create recurring consent (201).

date●
bodystring

Payment date (`YYYY-MM-DD`).

payment●
bodyobject

Payment instruction — amount and currency of the transfer.

amount●
bodystring

Payment amount (decimal string).

currency●
bodystring

Currency code (ISO 4217).

creditorAccount●
bodyobject

Creditor account for settlement.

ispb●
bodystring
issuer●
bodystring
number●
bodystring
accountType●
bodystring
remittanceInformation●
bodystring

Pix remittance information / purpose text.

authorisationFlow●
bodystring

Authorisation flow identifier (for example `HYBRID_FLOW`).

localInstrument●
bodystring

`MANU`, `DICT`, or `INIC` per arrangement rules.

document●
bodyobject

Payer document context.

identification●
bodystring
rel●
bodystring
originalRecurringPaymentId●
bodystring

Original recurring payment reference required by the arrangement.

riskSignals●
bodyobject

Risk telemetry — provide either `manual` or `automatic` (not both required).

manual
bodyobject
deviceId●
bodystring
isRootedDevice●
bodyboolean
screenBrightness●
bodynumber
elapsedTimeSinceBoot●
bodynumber
osVersion●
bodystring
userTimeZoneOffset●
bodystring
screenDimensions●
bodyobject
width●
bodynumber
height●
bodynumber
accountTenure●
bodystring
geolocation●
bodyobject
latitude●
bodynumber
longitude●
bodynumber
type●
bodystring
isCallInProgress●
bodyboolean
isDevModeEnabled●
bodyboolean
isMockGPS●
bodyboolean
isEmulated●
bodyboolean
isMonkeyRunner●
bodyboolean
isCharging●
bodyboolean
antennaInformation●
bodyboolean
isUsbConnected●
bodyboolean
integrity●
bodyobject
appRecognitionVerdict●
bodystring
deviceRecognitionVerdict●
bodystring
automatic
bodyobject
lastLoginDateTime●
bodystring · date-time

Last time the payer interacted with your app.

pixKeyRegistrationDateTime●
bodystring · date-time

When the Pix key was registered with you (required when `localInstrument` is DICT or INIC).

curl --request POST \
  --url 'https://embedded-payment-manager.hml.linaob.com.br/api/v1/automatic-payments/recurring-payments' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <SEU_TOKEN>' \
  --header 'subTenantId: subtenant_abc123' \
  --data '{
  "recurringConsentId": "urn:consent:abc123",
  "date": "2026-05-02",
  "payment": {
    "amount": "1500.50",
    "currency": "BRL"
  },
  "creditorAccount": {
    "ispb": "12345678",
    "issuer": "0001",
    "number": "1234567890",
    "accountType": "CACC"
  },
  "remittanceInformation": "Automatic sweep payment",
  "authorisationFlow": "HYBRID_FLOW",
  "localInstrument": "DICT",
  "document": {
    "identification": "76109277673",
    "rel": "CPF"
  },
  "originalRecurringPaymentId": "E9040088820210128000800123873170",
  "riskSignals": {
    "manual": {
      "deviceId": "device-uuid-001",
      "isRootedDevice": false,
      "screenBrightness": 0.75,
      "elapsedTimeSinceBoot": 120000,
      "osVersion": "17.4.1",
      "userTimeZoneOffset": "-03",
      "screenDimensions": {
        "width": 390,
        "height": 844
      },
      "accountTenure": "PT720H",
      "geolocation": {
        "latitude": -23.55,
        "longitude": -46.63,
        "type": "COARSE"
      },
      "isCallInProgress": false,
      "isDevModeEnabled": false,
      "isMockGPS": false,
      "isEmulated": false,
      "isMonkeyRunner": false,
      "isCharging": true,
      "antennaInformation": true,
      "isUsbConnected": false,
      "integrity": {
        "appRecognitionVerdict": "PASS",
        "deviceRecognitionVerdict": "PASS"
      }
    },
    "automatic": {
      "lastLoginDateTime": "2026-05-01T11:00:00Z",
      "pixKeyRegistrationDateTime": "2025-01-10T08:00:00Z"
    }
  }
}'

Response

201Recurring payment created successfully.
Response body
object
  • dataobjectrequired

    AutomaticPayment — see OpenAPI for the full field list.

    • idstringrequired

      Automatic payment id.

    • statusstringrequired

      Payment status such as `RECEBIDO`, `PENDENTE`, `EM_PROCESSAMENTO`, `PAGO`, `REJEITADO`, `ERRO`, etc.

    • paymentCurrencystringrequired

      Currency code (typically `BRL`).

    • paymentAmountstring

      Settled or instructed amount when available.

    • dueDatestring

      Settlement date (`YYYY-MM-DD`).

    • endToEndIdstring

      Pix end-to-end identifier when assigned.

    • recurringConsentIdstring

      Linked consent id.

    • automaticPaymentRequestobjectrequired

      Parent request summary — see OpenAPI.

  • messagestring

    Response message.

  • typestring

    Envelope type.

201 · Recurring payment created successfully.
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "EM_PROCESSAMENTO",
    "paymentCurrency": "BRL",
    "paymentAmount": "1500.50",
    "dueDate": "2026-05-02",
    "recurringConsentId": "urn:consent:abc123",
    "automaticPaymentRequest": {
      "id": "f3b4e8c2-2c1d-4f6a-9c1e-5a92f3a7d8a1"
    }
  },
  "message": "",
  "type": "success"
}

Next steps