Confirm a Wasl Card Order and Retrieve Card Codes

Finalise a reserved card order by submitting your payment reference, and receive redeemable card codes and numbers ready for delivery to your customers.

After initiating a card request and receiving a transaction_id, you call this endpoint to confirm the order and complete the purchase. Wasl processes the payment reference you provide and returns the actual card codes and card numbers that you deliver to your customers. This is the final step in the card order flow.

You must call Initiate Card Request first and use the transaction_id it returns. Attempting to confirm an order without a valid transaction_id from a prior initiation will fail.

Endpoint

POST /api-service/card/confirm-order

Base URL (Development)

https://development.payzah.net

Request Headers

Header	Value
Content-Type	application/json
Authorization	<your token>
Token	token

Request Body

transaction_id · string · required

The transaction ID returned by the initiate-card-request endpoint. This links the confirmation to the earlier reservation.

total_amount · double · required

The total monetary amount for the order. This should match the value of the cards being confirmed.

payment_id · string · required

Your internal payment reference identifier. Use this to correlate the Wasl transaction with your payment records.

Example Request

Request

{
  "transaction_id": "244101585669013",
  "total_amount": 6.6,
  "payment_id": "12345672312"
}

cURL

curl --request POST \
  --url https://development.payzah.net/api-service/card/confirm-order \
  --header 'Authorization: <your token>' \
  --header 'Content-Type: application/json' \
  --header 'Token: token' \
  --data '{
    "transaction_id": "244101585669013",
    "total_amount": 6.6,
    "payment_id": "12345672312"
  }'

Response

On success, Wasl returns an array of card objects under the data key. Each object contains a redeemable code and a card number corresponding to one of the cards in your order.

status · boolean

true when the order was confirmed successfully.

code · string

A response code for the operation. "11111" indicates success.

data · array

An array of card objects — one entry per card in the order.

Show data item fields

card_code · string

The redeemable card code to deliver to your customer. Guard this value carefully — it has monetary value.

card_number · string

The card number associated with this card code.

Example Response

Response

{
  "status": true,
  "code": "11111",
  "data": [
    {
      "card_code": "QWERTY123",
      "card_number": "123456789"
    },
    {
      "card_code": "QWERTY123",
      "card_number": "123456789"
    }
  ]
}

Deliver card codes to your customers promptly after receiving them. Card codes have monetary value — treat them as sensitive data in transit and at rest. If a card turns out to be faulty or unredeemable, use the Cards Console Panel to request a replacement from Wasl support.

The number of objects in the data array will match the quantiry value you specified during the initiate step. Verify the count before delivering codes to customers.