Create a payment instrument

Tokenization

Use iframe from tokenization-form-environment.synswi.com/card-form and tokenization-form-environment.synswi.com/bank-form with query parameter accountId

Environment can bedev or sandbox depending on account setup

Render the iframe

Post message with a type of submit_form to iframe

Listen to message event with type of tokenization_success to get the paymentInstrumentId

Below are all the messages events the iframe emits:

This event tells the paymentInstrumentId that you will use to create a transaction

{ 
    paymentInstrumentId: "string", 
    type: "tokenization_success" 
}

This event is emitted when the tokenization fails for some reason. Message field contains the relevant reason

{ 
    message: "string", 
    type: "tokenization_failure"
}

This event is emitted every second, and the height field tells the current iframe content's height. You could listen to this event to dynamically update the iframe's container's height

{ 
    height: "number", 
    type: "set_height"
}

Below are all the messages that you will send to iframe:

This event tells the iframe to create a payment instrument using the information currently in the form

This event tells the iframe to clear all the contents in the form

Create a payment instrument

Tokenization#

Tokenization