Push To Card Widget

The Push To Card Widget allows you to embed an iframe into your site for credit card number entry. This widget communicates directly with KyckGlobal so you have no PCI security concerns. Follow the steps below to use it.

Step 1: Unique ID Generation#

For security reasons, we generate a unique ID per client for use in the widget. Please contact support@kyckglobal.com and let them know you need a widget ID with the following information:

Environment (sandbox or production)
desired callback URL

Step 2: Payee Auth Token#

Before loading the iframe, you need to request a unique auth token for the payee. This request needs your unique ID as well as the payee email. See below for documentation of the call.

Request Body#

{ 
    "uniqueId" : "<Unique ID>", 
    "payeeEmail" : "<Payee Email Address>" 
} 

Response Body#

{ 
    "success": true, 
    "message": "Success", 
    "baseUrl": "https://api.kyckglobal.com/pushToCard/kyck/",     
    "responseToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXllZUVtYWlsIjoiZXJ1bGFwcGFuK3AyY21ldGEwMDFAdGVjaG1hbmdvLm5ldCIsI nBheWVlSWQiOiJQYXllZTI1NDAzMTEzIiwicGF5ZXJJZCI6IlBheWVyMDAyNTQiLCJvcmdhbml6YXRpb25JZCI6IkswNTI1NzRQIiwi dmVyaWZpZWQiOnRydWUsImlhdCI6MTYwNTczMTYwOSwiZXhwIjoxNjA2MzM2NDA5fQ.l3XPTWoaX1hnDJyHbXUe9SRC_D AjvAtmOqPjXjBXE60" 
}

Step 3:Widget Usage#

Include the following tag in your web page to consume the widget:

<iframe id="pushToCardIframe" 
src="https://api.kyckglobal.com/pushToCard/kyck/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXllZUVtYWlsIjoiZXJ1bGFwc GFuK3AyY21ldGEwMDFAdGVjaG1hbmdvLm5ldCIsInBheWVlSWQiOiJQYXllZTI1NDAzMTEzIiwicGF5ZXJJZCI6IlBheWVyMDAyN
TQiLCJvcmdhbml6YXRpb25JZCI6IkswNTI1NzRQIiwidmVyaWZpZWQiOnRydWUsImlhdCI6MTYwNTczMTYwOSwiZXhwIjoxNjA
2MzM2NDA5fQ.l3XPTWoaX1hnDJyHbXUe9SRC_DAjvAtmOqPjXjBXE60" width="900" height="350"></iframe> 

Step 4: Callback#

Once the user inputs the required fields and the card is successfully added, KyckGlobal will initiate the callback to the address specified by the widget unique ID.

Callback URL#

http://{baseUrl}/kyck/pushToCardCallback

The {baseUrl} will match the value you specify during unique ID generation.

Callback Body#

Callback Response: 
{ 
    "success": true, 
    "message": "Account Updated Successfully.", 
    "payeeEmail": "< Payee Email Address>", 
}