Webhooks

Events

Subscribe an endpoint to the events below, or to * for every event, including ones added later.

Payments

`payment.created`

A payment was created, from the dashboard or the API. Its link is ready to send to the sender.

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "open",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "held",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": null,
    "reference_number": null,
    "termination_reason": null,
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": null,
    "transfer_expires_at": null,
    "reference_submitted_at": null,
    "refusable_at": null,
    "auto_confirms_at": null,
    "finalized_at": null,
    "terminated_at": null
}

`payment.claimed`

The sender opened the link and joined the payment. They now describe the deal on their side, without seeing yours.

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "negotiating",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "held",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": {
        "name": "Yacine Belkacem",
        "is_guest": false,
        "verified": true
    },
    "reference_number": null,
    "termination_reason": null,
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": "2026-11-02T10:14:51+01:00",
    "transfer_expires_at": null,
    "reference_submitted_at": null,
    "refusable_at": null,
    "auto_confirms_at": null,
    "finalized_at": null,
    "terminated_at": null
}

`payment.approved`

The auditor found that both descriptions of the deal match. The sender can now ask for your RIP.

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "approved",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "held",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": {
        "name": "Yacine Belkacem",
        "is_guest": false,
        "verified": true
    },
    "reference_number": null,
    "termination_reason": null,
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": "2026-11-02T10:14:51+01:00",
    "transfer_expires_at": null,
    "reference_submitted_at": null,
    "refusable_at": null,
    "auto_confirms_at": null,
    "finalized_at": null,
    "terminated_at": null
}

`payment.blocked`

The payment was stopped: the descriptions did not match, the sender said you are not the person they negotiated with, or the El-B team freed its transaction number after a report. See termination_reason.

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "blocked",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "held",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": {
        "name": "Yacine Belkacem",
        "is_guest": false,
        "verified": true
    },
    "reference_number": null,
    "termination_reason": "arbiter_blocked",
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": "2026-11-02T10:14:51+01:00",
    "transfer_expires_at": null,
    "reference_submitted_at": null,
    "refusable_at": null,
    "auto_confirms_at": null,
    "finalized_at": null,
    "terminated_at": "2026-11-02T10:16:40+01:00"
}

`payment.transfer_started`

The sender was shown your RIP and the transfer window started (15 minutes). Also sent when you reopen an expired window.

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "transfer_window",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "held",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": {
        "name": "Yacine Belkacem",
        "is_guest": false,
        "verified": true
    },
    "reference_number": null,
    "termination_reason": null,
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": "2026-11-02T10:14:51+01:00",
    "transfer_expires_at": "2026-11-02T10:31:22+01:00",
    "reference_submitted_at": null,
    "refusable_at": null,
    "auto_confirms_at": null,
    "finalized_at": null,
    "terminated_at": null
}

`payment.expired`

The transfer window ended before the sender entered a transaction number.

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "expired",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "held",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": {
        "name": "Yacine Belkacem",
        "is_guest": false,
        "verified": true
    },
    "reference_number": null,
    "termination_reason": null,
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": "2026-11-02T10:14:51+01:00",
    "transfer_expires_at": "2026-11-02T10:31:22+01:00",
    "reference_submitted_at": null,
    "refusable_at": null,
    "auto_confirms_at": null,
    "finalized_at": null,
    "terminated_at": null
}

`payment.reference_submitted`

The sender entered the BaridiMob transaction number (Reference number). Check that the transfer reached your account, then confirm it.

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "awaiting_confirmation",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "charged",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": {
        "name": "Yacine Belkacem",
        "is_guest": false,
        "verified": true
    },
    "reference_number": "418306259147",
    "termination_reason": null,
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": "2026-11-02T10:14:51+01:00",
    "transfer_expires_at": "2026-11-02T10:31:22+01:00",
    "reference_submitted_at": "2026-11-02T10:24:37+01:00",
    "refusable_at": "2026-11-04T10:24:37+01:00",
    "auto_confirms_at": "2026-11-05T10:24:37+01:00",
    "finalized_at": null,
    "terminated_at": null
}

`payment.finalized`

The payment is complete: you confirmed it, it was confirmed automatically after the waiting period, or you closed it with the amount that actually arrived (received_amount_dzd).

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "finalized",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "charged",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": {
        "name": "Yacine Belkacem",
        "is_guest": false,
        "verified": true
    },
    "reference_number": "418306259147",
    "termination_reason": null,
    "auto_confirmed": false,
    "receipt_url": "https://el-b.com/r/7HQ2MXKD9RTA",
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": "2026-11-02T10:14:51+01:00",
    "transfer_expires_at": "2026-11-02T10:31:22+01:00",
    "reference_submitted_at": "2026-11-02T10:24:37+01:00",
    "refusable_at": null,
    "auto_confirms_at": null,
    "finalized_at": "2026-11-02T13:40:18+01:00",
    "terminated_at": null
}

`payment.cancelled`

The payment ended without a confirmed transfer: you cancelled it, you reported that the transfer never arrived, or the El-B team cancelled it. See termination_reason.

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "aborted",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "returned",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": null,
    "reference_number": null,
    "termination_reason": "seller_cancelled",
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": null,
    "transfer_expires_at": null,
    "reference_submitted_at": null,
    "refusable_at": null,
    "auto_confirms_at": null,
    "finalized_at": null,
    "terminated_at": "2026-11-02T11:02:09+01:00"
}

`payment.status_changed`

Any change of status, with previous_status. Sent alongside the specific event above, and alone for the intermediate statuses (arbitrating, arbitration_failed).

Example data

{
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "label": "Order #1042",
    "status": "awaiting_confirmation",
    "amount_dzd": 45000,
    "received_amount_dzd": null,
    "credit_cost": 4,
    "credit_state": "charged",
    "join_mode": "verified",
    "payment_information": {
        "deliverable": "iPhone 13, 128 GB, used",
        "fulfillment_target": "Hand delivery in Bab Ezzouar, Algiers",
        "platform": "Facebook Marketplace",
        "recipient_handle": "Phone Store DZ"
    },
    "sender": {
        "name": "Yacine Belkacem",
        "is_guest": false,
        "verified": true
    },
    "reference_number": "418306259147",
    "termination_reason": null,
    "auto_confirmed": false,
    "receipt_url": null,
    "created_at": "2026-11-02T10:12:03+01:00",
    "claimed_at": "2026-11-02T10:14:51+01:00",
    "transfer_expires_at": "2026-11-02T10:31:22+01:00",
    "reference_submitted_at": "2026-11-02T10:24:37+01:00",
    "refusable_at": "2026-11-04T10:24:37+01:00",
    "auto_confirms_at": "2026-11-05T10:24:37+01:00",
    "finalized_at": null,
    "terminated_at": null,
    "previous_status": "transfer_window"
}

Credits

`credits.low`

Your balance can no longer cover one credit. New payments need credits; payments already created are not affected.

Example data

{
    "free_credits": 0,
    "paid_credits": 0,
    "available_credits": 0
}

Webhooks

`webhook.test`

A test delivery, sent on request to check an endpoint.

Example data

{
    "message": "This is a test delivery from El-B."
}

When a payment changes status, its specific event comes first, then payment.status_changed. Subscribe to one or the other to avoid handling the change twice.