Notify the payment facilitator about a successful credit

post

https://sandbox.examplebank.com/blinc/credit-notifications

A Credit Notification tells the payment facilitator that its acquiring bank completed the merchant credit. The notification does not move money or create another credit; the receiving institution acknowledges the report. If Blinc does not receive a response, it may deliver the same notification again, and the institution should return the acknowledgement for that report without treating it as a new credit. Read how to notify the payment facilitator about a successful credit.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Signed and encrypted request body. The JSON body contains the Base64 data envelope. Content-Type must be application/json, and the signature is supplied in the x-signature header.

The complete HTTP body. The data value is the Base64-encoded encrypted envelope. The institutional ECDSA signature is supplied in the x-signature header, not in the JSON body.

data

string

required

Base64-encoded bytes joined in this order: the one-use P-256 public key (65 bytes), the 12-byte nonce, the AES-256-GCM ciphertext, and the 16-byte authentication tag. Derive the AES key with ECDH and HKDF-SHA256 using the info value blinc-e2ee.

Headers

x-timestamp

string

required

UTC time when this protected HTTP delivery was created. Use yyyy-MM-dd'T'HH:mm:ss.fff'Z' and reject stale or future deliveries outside the agreed clock-skew window.

x-signature

string

required

Base64 of the 64-byte IEEE P1363 P-256 ECDSA signature over the exact compact plaintext UTF-8 bytes.

Responses

Language

Loading…

Response

Choose an example:

application/json

200The institution received the protected request and returned a protected business result. Decrypt the body to read whether the business action was accepted or rejected.

400Validation failures return ordinary, unencrypted error JSON.