A payment webhook is a POST url delivered by the API partner to November First. Calls to the payment webhook is triggered every time there is a change in:

  1. Payment Status
  2. Approval Status

Calls to the Payment webhook is delivered in this format:

"{\"CustomerCVR\":\"28860633\",\"PaymentReference\":\"1TYY9IDKTBC\",\"PaymentStatus\":\"Pending\",\"ApprovalStatus\":\"Pending\",\"CustomerNumber\":\"208100006\",\"RecipientName\":\"Jonas Test\",\"ToAmount\":200.0000,\"ToCurrencyCode\":\"ISK\",\"InitiationStatus\":null,\"IsSepa\":false,\"FeeSharingType\":\"Shared\"}"

IMPORTANT The webhook object has a Payment Status with extra options. The options are described below:

PAYMENT STATUS VALUES:
Pending: Payment Created but not ready to be paid.
Scheduled: Payment to be paid at a future date.
AwaitingCustomerPayment: Payment executed and awaiting the customer funds to our account.
AwaitingTransfer: Payment ready to be sent to the recipient.
Completed: Payment sent to the final recipient.
TradeReverted: International payment canceled.
TransferForbidden: Payment cannot be sent because the recipient is restricted.
Canceled: Payment canceled by November First or customer request.
PendingApproval: the payment is pending approval.
Approved: the payment has been approved and ready to be paid.
Rejected: the payment has been rejected by an approver.
PartiallyApproved: the payment needs additional approvers.

The description of each field of the webhook is described below:

Field

Decription

CustomerCVR

The CVR of the customer.

PaymentReference

The reference of the payment.

PaymentStatus

The WEBHOOK PAYMENT STATUS, please dont confuse it with the PaymentStatus. the values for this field are described above.

ApprovalStatus

The Status of the Approval, with values: Initiated, Approved, Rejected.

CustomerNumber

The november first customer number.

RecipientName

The name of the recipient of the payment.

ToAmount

The amount to be send to the recipient.

ToCurrencyCode

The currency of the "ToAmount" field.

InitiationStatus

The Payment initiation status, with values: Initiated, Sent, Accepted, Rejected.

IsSepa

A boolean field in case the payment is within the SEPA region.

FeeSharingType

The fee sharing type of the payment:

The API partner can provide a generic webhook url which receives calls on all payments created through the partners' integration, or the partner kan include the webhook in the "WebHookUrl" string field when the partner creates payments.