Skip to content

Credit card alternative

SP Integration option

Payment

Info

This integration option supports only DZD currency.

Payment flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends a payment request to the bePaid.
  3. bePaid sends a response containing the URL for completing the payment.
  4. The merchant redirects the customer to the provided URL.
  5. The customer submits their card details and completes the payment.
  6. bePaid sends a webhook notification with the payment status to the merchant.
Request

Send a payment request with the following additional parameters:
object
return_url
required
 string
URL to return the customer to when the transaction is completed.
object
A section of the payment method information.
type
required
 string
credit_card_alternative
object
A section of information about the customer.
first_name
 string
The customer's first name.
last_name
 string
The customer's last name.
email
 string
The customer's email address.
address
 string
The customer's address.
phone
 string
The customer's phone number.
Request example 
{
    "request": {
        "test": true,
        "amount": 10000,
        "currency": "DZD",
        "description": "description",
        "notification_url": "https://notification_url",
        "return_url": "https://return.com",
        "method": {
            "type": "credit_card_alternative"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Willson",
            "phone": "123456789",
            "address": "First Str. 2",
            "email": "john.willson@example.com"
        }
    }
}
Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example 
{
    "transaction": {
        "uid": "3e61138b-0bb4-4780-b717-d84f3bb63cd8",
        "type": "payment",
        "status": "pending",
        "amount": 10000,
        "currency": "DZD",
        "description": "description",
        "created_at": "2025-11-25T14:49:54Z",
        "updated_at": "2025-11-25T14:49:55Z",
        "method_type": "credit_card_alternative",
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/3e61138b-0bb4-4780-b717-d84f3bb63cd8/40cf4beffb2cc89975d618988b0db2483abc70bfa2ae6639b278eb90802544cb",
        "payment": {
            "status": "pending",
            "gateway_id": 5420,
            "ref_id": "363785",
            "message": "Facture créée avec succès."
        },
        "credit_card_alternative": {
            "type": "credit_card_alternative"
        },
        "customer": {
            "email": "john.willson@example.com",
            "phone": "123456789",
            "address": "First Str. 2",
            "last_name": "Willson",
            "first_name": "John",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Facture créée avec succès.",
        "test": true,
        "billing_address": {
            "email": "john.willson@example.com",
            "phone": "123456789",
            "address": "First Str. 2",
            "last_name": "Willson",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://sp/invoice/payment/PAY-0349545E5459/merchant",
            "method": "GET",
            "fields": []
        }
    }
}