Skip to main content
POST
Acknowledge that payment has been sent by the integrator
Notify Hashrails that you have initiated payment for a transfer request. You can confirm either a full or partial payment.
This endpoint serves as a payment notification. Actual settlement is triggered when the payment is detected via bank or blockchain confirmation.

Authorizations

Authorization
string
header
required

JWT access token from POST /v1/auth/token/issue. Send as: Authorization: Bearer <access_token>

Headers

x-idempotency-key
string
required

UUID v4 idempotency key to prevent duplicate confirmations.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

id
string
required

Unique transfer request ID

Example:

"c17d2777-e604-45e2-b6d5-7743652eadf1"

Body

application/json

Acknowledge that the full payment amount has been sent.

payment_type
enum<string>
required
Available options:
full
Example:

"full"

Response

Payment confirmation received

success
boolean
Example:

true

message
string
Example:

"Payment confirmation received"

data
object