Skip to content
Gowd Platform Production

Your postback notification for a scheduled payment status change.

POST
/order/example-postback-to-banking-scheduled-payment/[your_notification_url]

Every time a transaction has its status changed, your system will receive a notification from ours, so that you know if transactions were paid.

We expect that your system returns to ours: status code 200. If not, we’ll retry 4 more times.

Request Body required

Section titled “Request Body required ”
object
event
required

Webhook event for the scheduled payment status change.

string
Allowed values: SUBSCRIPTION.SCHEDULED_PAYMENT.ACCEPTED SUBSCRIPTION.SCHEDULED_PAYMENT.REJECTED SUBSCRIPTION.SCHEDULED_PAYMENT.COMPLETED SUBSCRIPTION.SCHEDULED_PAYMENT.ERROR SUBSCRIPTION.SCHEDULED_PAYMENT.CANCELED_INSUFFICIENT_BALANCE
Example
SUBSCRIPTION.SCHEDULED_PAYMENT.ACCEPTED
occurredAt
required

When the event occurred (UTC ISO-8601).

string
Example
2026-02-19T13:41:12.991Z
data
required

The updated scheduled payment data.

object
id
required

Identifier of the scheduled payment.

string
Example
7c3f2e2a-5b3a-4f7e-9a0a-2e2f9d0c1a2b
externalId
required

The unique code on the partner system.

string
Example
scheduled-payment-partner-id
subscriptionId
required

Identifier of the subscription this payment belongs to.

string
Example
550e8400-e29b-41d4-a716-446655440000
status
required

Status of the scheduled payment.

string
Allowed values: ACCEPTED REJECTED COMPLETED ERROR CANCELED_INSUFFICIENT_BALANCE
Example
ACCEPTED
purpose

Purpose of the scheduled payment.

  • FIRST_ATTEMPT and NEW_ATTEMPT_AFTER_DUE_DATE: created by the partner.
  • RESEND_DUE_TO_SETTLEMENT_ERROR: created by Gowd on the due date, until 21h, after the payer PSP canceled the original with reason SETTLEMENT_ERROR. Its id and externalId are not the partner ones; use settlementErrorRetryRootId to match it with the charge the partner created.
string
Allowed values: FIRST_ATTEMPT NEW_ATTEMPT_AFTER_DUE_DATE RESEND_DUE_TO_SETTLEMENT_ERROR
Example
FIRST_ATTEMPT
originalScheduledPaymentId

Scheduled payment this one refers to. On a RESEND_DUE_TO_SETTLEMENT_ERROR, the one it resends (on a second resend, the first resend); on a NEW_ATTEMPT_AFTER_DUE_DATE, the first attempt it retries. Not sent otherwise.

string
Example
7c3f2e2a-5b3a-4f7e-9a0a-2e2f9d0c1a2b
settlementErrorRetryRootId

Scheduled payment the partner created, the first of the chain of resends. Sent only on a RESEND_DUE_TO_SETTLEMENT_ERROR.

string
Example
7c3f2e2a-5b3a-4f7e-9a0a-2e2f9d0c1a2b
settlementErrorRetryAttempt

Attempt number of the resend, from 1 to 3. Sent only on a RESEND_DUE_TO_SETTLEMENT_ERROR.

number
Example
1
updatedAt
required

Date of the last status transition of the scheduled payment (UTC ISO-8601).

string
Example
2026-02-19T13:41:12.991Z
orderId

Identifier of the order generated by the payment. Sent only on SUBSCRIPTION.SCHEDULED_PAYMENT.COMPLETED.

string
Example
b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d
Examples

SUBSCRIPTION.SCHEDULED_PAYMENT.ACCEPTED

The scheduled payment was accepted by the payer bank and is waiting for the settlement date.

{
  "event": "SUBSCRIPTION.SCHEDULED_PAYMENT.ACCEPTED",
  "occurredAt": "2026-02-19T13:41:12.991Z",
  "data": {
    "id": "7c3f2e2a-5b3a-4f7e-9a0a-2e2f9d0c1a2b",
    "externalId": "scheduled-payment-2024-0001",
    "subscriptionId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "ACCEPTED",
    "updatedAt": "2026-02-19T13:41:12.991Z"
  }
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

The resource was returned successfully

object
returnCode
required

The current page.

string
Example
SUCCESS