Payments

Cancel a payment

End a payment before the sender enters the transaction number. Its credits come back to your balance. The sender is told.

POST https://el-b.com/api/v1/payments/{code}/cancel

Authorization

Authorizationheaderrequired

Bearer elb_sk_…: your API key, from API in your El-B account.

Path parameters

code string required

The payment's code.

Responses

Status	Meaning
`200`	Success. The body is shown alongside.
`404`	No payment with this code among the payments you receive.
`409`	The payment already ended, or the transaction number is in: it can no longer be cancelled.
`401`	Missing, unknown or paused API key.
`403`	The account is suspended, or no longer verified by an official document.
`429`	More than 60 requests in a minute. See Rate limits.

POST /payments/{code}/cancel

curl -X POST "https://el-b.com/api/v1/payments/Kx7pR2mQ9a/cancel" \
  -H "Authorization: Bearer $ELB_API_KEY" \
  -H "Accept: application/json"

use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('ELB_API_KEY'))
    ->acceptJson()
    ->post('https://el-b.com/api/v1/payments/Kx7pR2mQ9a/cancel');

$payment = $response->json('data');

const response = await fetch('https://el-b.com/api/v1/payments/Kx7pR2mQ9a/cancel', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.ELB_API_KEY}`,
    Accept: 'application/json',
  },
});

const { data } = await response.json();

import os
import requests

response = requests.request(
    "POST",
    "https://el-b.com/api/v1/payments/Kx7pR2mQ9a/cancel",
    headers={"Authorization": f"Bearer {os.environ['ELB_API_KEY']}"},
)

data = response.json()

Response · 200

{
    "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"
    }
}