Skip to main content
POST
/
b2b
/
iframeOrder
/
doPayment
Initiate iframe payment
curl --request POST \
  --url https://api2.wizzgift.com/b2b/iframeOrder/doPayment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "callback_url": "https://merchant.example.com/wizzgift/callback",
  "meta_data": {
    "user_id": "12345",
    "internal_order_id": "ORD-98765",
    "source": "wizzgift_iframe"
  }
}
'
{
  "success": true,
  "data": {
    "status": "pending",
    "iframe_session_id": "IFR-SESSION-123456",
    "message": "Payment session created."
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
jwt
string
required

Signed JWT token issued by WizzGift.

callback_url
string<uri>
required

Public HTTPS URL where WizzGift will send a POST callback with payment result.

meta_data
object
required

Arbitrary JSON object for merchant’s internal reference.

This will be returned unchanged in the callback payload.

Response

Payment successfully initiated.

success
boolean
required
data
object
required

Information about the created payment session.