SensePass Transaction API allows developers to create payment requests and proccess payments using SensePass network.

SensePass API organized around REST, accepts JSON request body and JSON response.

Our API also supports SOAP and XML.

Payment Methods

SensePass network supports multiple payment methods, including credit cards, Venmo, PayPal, Alipay, Klarna, WeChat Pay, Trustly, Coinbase, BitPay.

See our full payment methods list here

Testing

SensePass provides a fully functioning sandbox environment for development and testing, payments in the sandbox enviorement doesn't affect your live data or proccess money.

Environments

Authentication

Multiple authentication options are available, based on your use case:

POS

Authentication fields: deviceId

Only one field is required for authentication - deviceId, this field represents the unique identifier of the POS in SensePass network.

Device ID can be generated using the "match" API (Pairing) or using SensePass Partner platform.

E-Commerce

Authentication fields: merchant apiKey Or Location apiKey

apiKey can be associated to a merchant or to a location in specific merchant.

Merchant API key requires branchId field to be provided, Location API key does not requires branchId field.

Multiple authentication options are available, based on your use case:

POS

Authentication fields: deviceId

Only one field is required for authentication - deviceId, this field represents the unique identifier of the POS in SensePass network.

Device ID can be generated using the "match" API (Pairing) or using SensePass Partner platform.

E-Commerce Location API key

Authentication fields: apiKey

Location API key identifies the merchant and the location, Location API key is the recommended option for e-commerce.

E-Commerce Merchant API key (Deprecated)

Authentication fields: apiKey + branchNumber

Merchant API key requires branchId field to be provided.

Creating Authentication Keys

All of the keys types can be generated using our API or using or Partners Dashboard:

1. Location API key: Developer -> Branch API -> New

2. Merchant API Key: Developer -> Merchant API -> New

3. Device Id: POS/Register -> New

Examples

DeviceId Authentication

URL: /transactions/init

Request Body:

Merchant API Key Authentication

URL: /transactions/init

Request Body:

Location API Key Authentication

URL: /transactions/init

Request Body:

SensePass Transaction API allows developers to create payment requests and process payments using SensePass network.

SensePass API organized around REST, accepts JSON request body and JSON response.

Our API also supports SOAP and XML.

Payment Methods

SensePass network supports multiple payment methods, including credit cards, Venmo, PayPal, Alipay, Klarna, WeChat Pay, Trustly, Coinbase, BitPay.

See our full payment methods list here

Testing

SensePass provides a fully functioning sandbox environment for development and testing, payments in the sandbox enviorement doesn't affect your live data or proccess money.

Environments

Authentication

Multiple authentication options are available, based on your use case:

POS

Authentication fields: deviceId

Only one field is required for authentication - deviceId, this field represents the unique identifier of the POS in SensePass network.

Device ID can be generated using the "match" API (Pairing) or using SensePass Partner platform.

E-Commerce

Authentication fields: merchant apiKey Or Location apiKey

apiKey can be associated to a merchant or to a location in specific merchant.

Merchant API key requires branchId field to be provided, Location API key does not requires branchId field.

Idempotency

The optional header field idempotency-key can be used to uniquely identify a request to prevent duplicate operations.

When provided, the API uses this key to detect if an identical request has already been processed, ensuring that the operation is executed only once even if the client sends multiple identical requests.

This key is supported across all of our API's.

SensePass currently supports 10 e-commerce systems and we continue to add more integrations to our network.

• WooCommerce

• Gravity Forms

• JotForm

• Zapier

• PrestaShop

• Oracle Netsuite SuiteCommerce

• Shopify

• BigCommerce

• PayTech Trust

• Magento

SensePass currently supports 20 POS systems and we continue to add more POS to our network.

• Microsoft Dynamics 365 (D365)

• Microsoft Dynamics 365 Business Central (D365 Business Central)

• RMH

• RMH iPOS

• Oracle Micros X-Store

• Oracle Netsuite NSPOS

• Oracle Netsuite ERP

• Oracle Netsuite SCIS

• VRP

• Lightspeed R (previously Vend)

• Shopify POS

• Anthology - Student Management

• Aptos

• Dimension Computer

• NCR

• Prism RBS - POS + MPOS

• PAR

• Vela POS

• SABX POS

• Storis

Terminal Agent works as a proxy to all SensePass cloud API describes in this docs.

In addition, Terminal agent allows you to use specific API's created for the Terminal Agent software.

Authentication

Stroing and sending Device ID in the request body is not required for all API requests, Terminal Agent stores and will append this data to your requests automatically.

Web Server

Instead of calling our cloud API (api.sensepass.com / api.sandbox.sensepass.com) - just change the base URL of your requests to http://localhost:8003/

Example: http://localhost:8003/api/transactions/init

The schema of this requets is identical to the cloud API.

Sandbox playground: https://js.sandbox.sensepass.com

Production playground: https://js.sensepass.com

The flow chart below describes the possible transitions between Transaction status, see "status" field in

Terminal Agent expose an API to get the paired device ID.

Usage Flow:

1. Call GET request to: http://localhost:8003/api/devices Without any request payload

2. Reponse will return immediately with the device ID

Example

URL: http://localhost:8003/api/devices

Response body:

This flow is useful for POS who would to send an API call on each cart update event, this will allow the customer to see the order information in realtime on the EMV Pinpad device and on SensePass tag.

Step 1 - Send product information on every cart change

POST

Step 2 - Call Init as usual once the POS is ready to accept payment (Sync/Async)

POST

OR

The flow chart below describes the typical payment flow for POS and E-commerce.

Getting Started

1. Ensure your system meets the mentioned requirements

2. Login to SensePass Partners

3. Navigate to "Developers" -> "Terminal Agent"

1. Download the latest version of Terminal Agent software using the download link on the partners page

2. Click on the green button "Download config file"

Installation

1. Double click on the EXE file in your downloads folder and start the installation process

2. Click on "I agree" and click "Install"

1. Setup will complete with this message:

1. Move the config.json file from #5 to this location:

C:\Program Files (x86)\SensePass Ltd\Terminal Agent

1. Open the Services app (Run -> services.msc)

2. Look for "SensePass-Agent-V2", right click -> Restart

Pairing

These models are part of request and response:

Implement Socket.IO client on your platform and listen to this URL:

Production - https://api.sensepass.com?id=id_<Device_Id>

Sandbox - https://api.sandbox.sensepass.com?id=id_<Device_Id>

Listen to "message" event to get notifcations about the transaction for a specific device.

Read here about Socket.IO:

Configuration

1. Double click on "SensePass Configurator" icon on your desktop, if you can't find it - open your browser with this URL: http://localhost:3031

1. This screen will be shown:

Location - Choose the current location for your POS, adding locations to this list can be performed using the Partners platform

EMV - Choose the required pinpad type

POS Name - friendly name for the POS that will be shown in the merhcnat dashboard to recognize your payments

Pairing Code - the (XXX-XXX-XXX) code that is shown below the QR code on the SensePass tag

Click on the "Continue" button and close the window after the succesful pairing message presented.

All set !

Accept any payment app, any wallet, any card any way your customer wants.

SensePass supports currently 107 payment methods with a single API interface for all of them, we continue to add payment methods to our network.

Credit Cards (27)

• Cardknox

• NMI

• TSYS

• Shift4

• Authorize.net

• Elavon

• Clover

• Moneris

• Chase

• Nuvei

• DLocal

• Adyen

• Coastal Pay

• Stripe

• Square

• Shopify Payments

• Linkly

• Westpac

• First Data

• Global Payments

• Heartland Payment

• Worldpay

• North American Bancard

• Electronic Payment Exchange (EPX)

• Braintree

• Blink

• Viva

Wallets (9)

• Apple Pay

• Google Pay™

• PayPal

• Venmo

• Amazon Pay

• Samsung Pay

• AliPay

• WeChat Pay

• Kakao Pay

Buy Now Pay Later - BNPL (10)

• Klarna

• SplitIt

• Sezzle

• ChargeAfter

• AfterPay

• Zip

• Affirm

• WeGetFinancing

• Jifiti

• Skeps

Bank Payments (4)

• Trustly

• ACH

• EFT

• Link Money

LATAM, Asia, Africa (54)

• Mobile Money

• PIX

• Boleto

• Abitab

• PSE

• OXXO

• MercadoPago

• SPEI

• Pago Efectevio

• Infonet

• Pago al Paso

• Pago Efectivo

• Pay Cash

• Pay Valida

• Yape

• au PAY

• Dana

• dBarai

• DragaonPay

• DuitNow

• Kobini

• LINE Pay

• Lpay

• Merpay

• Momo wallet

• Naver Pay

• NPP

• Payco

• PayPay

• PromptPay

• QRIS

• Rakuten Pay

• SSGPAY

• TOSS Payments

• Touch 'n Go

• TrueMoney

• UPI

• ZaloPay

• CLAVE

• CoDi

• Daviplata

• Efecty

• Nequi

• Pay4Fun

• Sencillito

• WebPay

• Rapipago

• Cobro Express

• Pago Facil

• PicPay

• NuPay

• Sencillito

• Khipu

• Servipag

• Sinpe

• Sinpe Movil

• PuntoXpress

• Akisi

• Practipago

• Wepa

• Zimple

• Sigo Money

• Billetera Personal

• Wally

• Giros Claro

• BCP

• Payvalida

• Redpagos

Crypto (3)

• Coinbase

• BitPay

• PalWallet

API for Fetching Payment Providers

GET /transactions/paymentProviders/list

Request Body

[
  {
    "name": "PayPal",
    "description": "Paypal Production",
    "type": "wallet",
    "confirmationPrefix": "145",
    "isPartialRefundSupported": true,
    "environment": "Production",
    "providerId": "FLTBxa5D/z/gmjdNeTm0IXNVOOaiyhQBqRrIaTs1kcI="
  }
]

{
    // Response
}

API for Fetching Payment Methods by method type

GET /transactions/paymentProviders/payment-methods

Request Body

{
	"paymentMethods": [
		{
		  "id": 3,
		  "name": "credit-card",
		  "type": "credit-card"
		},
		{
		  "id": 4,
		  "name": "paypal",
		  "type": "wallet"
		},		
	]
}

{
    // Response
}

All merchants must adhere to the Google Pay APIs Acceptable Use Policy and accept the terms defined in the Google Pay API Terms of Service.

Google Pay is a trademark of Google LLC.

Adding receipt to your payment request alllows your customers to view the full payment receipt on their mobile device immediately after the payment approved, and on their SensePass account.

Receipt full documentation: Receipts Model

URL: /transactions/init

Request Body:

{
  "timeOut": 600,
  "amount": 200,
  "isCent": true,
  "currency": "USD",
  "deviceId": "2ooeww5ufzg3nkuf8a10gu5n695yolixlbgb042o03to9bxfkr7t815i5epu8o58jv1rznif3o1tr6xsb1rm",
  "receipt": {
    "mode": 1,
    "accountingProvider": 4,
    "receiptInfo": {
      "customerId": "123456789",
      "firstName": "John",
      "lastName": "Doe",
      "address": "Begin Dw 12",
      "city": "Tel Aviv",
      "zipCode": "90745",
      "socialID": "123456789",
      "phoneNumber": "5551112232",
      "languageCode": "en",
      "currencyCode": "USD",
      "email": "[email protected]",
      "discount": 0,
      "vat": true
    }
  },
  "receiptNotifications": {
    "email": [
      "[email protected]"
    ],
    "sms": [
      "9295522135"
    ]
  }
}

API for creating a dynamic QR without using SensePass tags.

API Interface

Create Device

POST https://api.sensepass.com/api/devices/create

API for creating a device without using SensePass tags.

Request Body

{
  "name": "POS",
  "deviceAliasKey": "syi2vm59le3zf7r9og29ezz12xin95vxhewuzdhu0c4cqizeu9d3yvs8rhn60el4eqr4iq6qozrguyw7rgrgqiec6abb9ftygfhvvwl9ar833i1ztnghj7k9zkrvrw5e8ykd2bueemddgcygwci3q12u4fu07ivxm1i7tw50wog7n9mu1pirdj0cg188mbvdf4axxpgc98udh71kxnu9i56yrm207msqrtl0hj44mvoibt4nanvenr06hpq9h9tq",
  "merchantUID": "string",
  "branchUID": "string",
  "clientBoxes": [
    "https://pay.sensepass.com/c_EG9RW3DMJ4WDRF7KFN5A0ICSB0UU16"
  ]
}

{
    // Response
}

{
    // Response
}

Examples

Creating a new device ID for a tag

{
  "apiKey": "a1b2c3d4e5f6g7h8",
  "posName": "NewYorkBranchPos"
}

Response

{
  "name": "POS",
  "deviceAliasKey": "syi2vm59le3zf7r9og29ezz12xin95vxhewuzdhu0c4cqizeu9d3yvs8rhn60el4eqr4iq6qozrguyw7rgrgqiec6abb9ftygfhvvwl9ar833i1ztnghj7k9zkrvrw5e8ykd2bueemddgcygwci3q12u4fu07ivxm1i7tw50wog7n9mu1pirdj0cg188mbvdf4axxpgc98udh71kxnu9i56yrm207msqrtl0hj44mvoibt4nanvenr06hpq9h9tq",
  "merchantUID": "string",
  "branchUID": "string",
  "clientBoxes": [
    "https://pay.sensepass.com/c_EG9RW3DMJ4WDRF7KFN5A0ICSB0UU16"
  ]
}

Adding receipt to your payment request alllows your customers to view the full payment receipt on their mobile device immediately after the payment approved, and on their SensePass account.

Receipt full documentation: Receipts Model

Request Body:

{
  "timeOut": 600,
  "amount": 200,
  "isCent": true,
  "currency": "USD",
  "apiKey": "2ooeww5ufzg3nkuf8a10gu5n695yolixlbgb042o038o58jv1rznif3o1tr6xsb1rm",
  "returnURL": "https://merchantDomain.com/thankYouPage",
  "cancelURL": "https://merchantDomain.com/cart",
  "callbackURL": "https://merchantDomain.com/sensepass/callbackEndPoint",
  "receipt": {
    "mode": 1,
    "accountingProvider": 4,
    "receiptInfo": {
      "customerId": "123456789",
      "firstName": "John",
      "lastName": "Doe",
      "address": "Begin Dw 12",
      "city": "Tel Aviv",
      "zipCode": "90745",
      "socialID": "123456789",
      "phoneNumber": "5551112232",
      "languageCode": "en",
      "currencyCode": "USD",
      "email": "[email protected]",
      "discount": 0,
      "vat": true
    }
  },
  "receiptNotifications": {
    "email": [
      "[email protected]"
    ],
    "sms": [
      "9295522135"
    ]
  }
}

This model represents additional data that can be sent to the processor, currently only used by Klarna.

Currently the data passed in the Additional Data Model is sent to klarna as EMD (extra merchant data), as of now, we support the passing of the following fields: "other_delivery_address" and "trip_reservation_details", the data can be seen also in the Klarna docs here: https://docs.klarna.com/api/extra-merchant-data/

Example

Basic example of "additionalData" object sent in the Transactions/Init request body

"additionalData": {
    "trip_reservation_details": {
        "min_age": 18,
        "max_age": 60
    },
    "other_delivery_address": {
        "shipping_method": "store pick-up",
        "shipping_type": "normal"
    }
}

This model represents settlement status & final-confrimation value from the proccessor, the entity contains all the required data for accounting reports.

Settlement Model

This model is referenced in the "settlement" field of the Confirmation Model object.

SensePass Token Migration Process

The SensePass token migration process allows merchants to securely transfer customer payment information for tokenization.

This process involves the merchant sending a structured Excel file, which contains sensitive customer data such as credit card numbers, expiration dates, and other relevant information.

The process can be completed in two distinct workflows:

Workflow 1: Generating New Tokens

1. File Submission: The merchant submits an Excel file following the prescribed format available on our documentation page. This file should include all required customer data fields.

2. Tokenization by SensePass: Upon receiving the file, SensePass processes the data by generating new, unique tokens for each credit card entry. These tokens are securely mapped to the original payment information within the SensePass system.

3. File Return: SensePass returns the processed file to the merchant. This file will contain the newly generated tokens, replacing the original credit card numbers, ensuring that sensitive data is securely handled.

Workflow 2: Using Merchant-Specified Tokens

1. File Submission: The merchant submits an Excel file in the standard format, including the existing tokens that they wish to retain. The file should also include the corresponding credit card numbers and other required customer data fields.

2. Token Matching by SensePass: SensePass processes the file by matching the provided tokens to the corresponding payment information within the system. This allows for the creation of identical tokens within the SensePass environment, ensuring seamless continuity for the merchant.

3. File Return: After processing, SensePass returns the file to the merchant with the specified tokens mapped to the original data, ensuring that the migration is completed without altering the token structure.

Excel File Template

Security and Compliance

SensePass follows stringent security protocols to ensure the safe handling of sensitive customer information throughout the token migration process.

All data is encrypted during transfer and processing, adhering to SOC 2 and PCI DSS standards.

All of our API's are organized around REST, accepts JSON request body and JSON response.

We also provide SOAP and XML Adapters for our REST API, using the same interface and entities.

The adapters are dynamic and will support all our future releases and endpoints.

SOAP Adapter

Docs about our SOAP Adapter

Payment commit is a mechanisim that allows SensePass to get acknowledgement from the POS or e-commerce website that the payment approval event identified and processed by the POS or e-commerce website.

This entity will be included in transaction-entity only for "Approved" status.

You are required to parse this entity and check whether the flag "isPaymentCommitted" (see below) is "true", in this case call "commitLink" URL with GET method, without any additional headers or query params. Calling this API will mark the transaction as "Payment Committed".

Payment Commit Model

This model is referenced in "paymentCommit" field of transaction-entity response body

See Settlement flow here

Installing a fresh SDK

Follow the documentation for installing SensePass element SDK:

Upgrading from SDK Version 1.0.9/1.1.0 (or below)

1. Update the SensePass SDK javascript link to version 1.1.1 (or above). For example: if your’e using https://js.sensepass.com/scripts/[email protected] -> you should update it to https://js.sensepass.com/scripts/[email protected] .

2. Update your configuration object with a key string payButtonId and a value string of your choosing, for example:

   Copy

   const paymentElementId = "my-payment-button";
   const spSdkConfig = {
      mode: "sandbox", // "sandbox" | "production"
      debug: true, // optional for logs
      visualizer: true, // optional visual logs, requires HTML with id="sensepass-front-end-visualizer"
      clientId: "aee8d2cdc1cb...", // Client ID
      methodType: "manual_capture", // type for the transaction, defaults to "manual_capture", enum: "manual_capture" | "tokenize" | "authorize"
      payButtonId: paymentElementId // id for the payment-button (element) the customer will click to start the payment process
   };

3. Update your HTML element that invokes the pay method from the SDK with an id attribute and value from step #2, e.g. id="my-payment-button".

Onboarding your domain for Apple Pay

1. Send SensePass the domain(s) you’ll use Apple Pay on. For example: - www.my-store.com - my-subdomain.my-store.com - my-other-store.com

2. Open public access from your website(s) to a file from the base path of your url. For example: - https://www.my-store.com/.well-known/apple-developer-merchantid-domain-association.txt. * This will let Apple validate your domain is associated with SensePass’s Apple account.

3. Receive from SensePass the apple-developer-merchantid-domain-association.txt file(s) and store them in your website(s). * SensePass will send you the file(s) in a .zip named to match it’s domain. Make sure to store the .zip content in its correct website.

4. Inform SensePass all apple-developer-merchantid-domain-association.txt file(s) are stored and publicly accessible.

5. Receive confirmation from SensePass that your domain(s) are Apple Pay ready.

This model represents the URL of the invoice, the invoice will be presented to the consumer before the payment processing.

Invoice Model

This model referenced in "invoice" field of request body.

This model represent the payment details as an input for creating a transaction.

Payment Details Model

This model referenced in "paymentDetails" field of request body

Credit Card Model

This model represent the list of Email and SMS addresses for sending receipts.

Receipt Notifications Model

This model referenced in "receiptNotifications" field of request body

Cancelling a pending transaction endpoint allows you to block the payment flow for consumers that currently visiting the payment page and also block the payment page for new consumers - only for specific transaction.

API Interface

Cancelling a pending transaction object (Payment Request)

POST https://api.sensepass.com/api/transactions/cancel/{transactionNumber}

Path Parameters

Authentication Request Body fields

Cancelling a pending transaction object using Device ID

POST https://api.sensepass.com/api/transactions/cancelByDeviceId/{deviceId}

This API will cancel the last pending transaction of a given device

Path Parameters

Authentication Request Body fields

Flow Chart

Transaction Status Flow

Customizable themes

When configuring the SDK, you may set the following code as the configuration object:

Download and edit the following themes you wish to style on your own:

1. Material theme:

2. SensePass theme:

3. Save your themes in a hosting site of your choosing and set their URL in the config JSON.

4. Use the to set you custom text and other UI configurations.

You may test your themes on our playground:

This model represents additional data that can be sent to the processor, currently used by Sola, TSYS and Stripe.

Example

Basic example of "processorData" object sent in the Transactions/Init request body

Payment commit is a mechanisim that allows SensePass to get acknowledgement from the POS or e-commerce website that the settlement event identified and processed by the POS or e-commerce website.

This entity will be included in only for "Approved" status (settlement).

You are required to parse this entity and check whether the flag "isPaymentCommitted" (see below) is "true", in this case call "commitLink" URL with GET method, without any additional headers or query params.

Calling this API will mark the transaction as "Payment Committed".

Payment Commit Model

This model is referenced in "paymentCommit" field of response body

SensePass Front-end SDK allows front-end websites to control SensePass's wide variety of a payment methods through a simple UI (iFrame).

Supported Payment Methods

1. Credit Cards

2. Apple Pay - No integration and authentication is required with Apple

3. Google Pay - No integration and authentication is required with Google

4. PayPal

5. Venmo

6. ACH

7. Affirm

8. Amazon Pay

9. Bit (IL locale)

SDK Flow

1. Add the SensePass's javascript SDK to your website's scripts ().

2. Initiate the SensePass client with your clientId

3. Listen to SDK events on the front-end

4. Call sensepass.pay() on form submission on the front-end

5. On successful callback from the SDK - get the transactionNumber

6. Call from your backend to the API /transactions/:transactionNumber/commit with the transactionNumber to capture the payment, see for further details

Security

1. The frontend uses client ID that does not have permissions to payment except for initalizing the SDK

2. The backend uses device ID / Merchant API Key / Branch API key for calling the

API

See the

This model represents the required data to redirect the consumer to the transaction page to complete the payment.

Transaction Page Model

This model referenced in "transactionPage" field of response body.

API to refund payments of approved transaction or partial refund transaction with available balance to refund.

This endpoint automaticlly detects if void or refund operation is required.

API Interface

Refund approved transaction object

POST https://api.sensepass.com/api/transactions/refund

Request Body

Authentication Request Body fields

See here our Authentication page

{
  "errorMessage": null,
  "errorCode": 0,
  "refundConfirmation": "063-LlgKAzfRL",
  "approvedBy": "PayPal",
  "refundBy": "PayPal",
  "dateApproval": "2019-12-19T09:47:59.105Z",
  "result": "Approved",
  "providerId": "z+n1opZ+RFn50fstklvWoOsovKIY5AUfsrVdGsO653c=",
  "transaction": {
    "TransactionNumber": "14a4334a32c852aeb0cfae52cbff1314649da7f175a8e140b35c147c",
    "date": "2019-12-19T09:47:59.105Z",
    "amount": 1234.56,
    "currency": "USD",
    "status": 0,
    "businessId": 144
  }
}

{
    // Response
}

{
    // Response
}

Example of Successful Refund

{
  "errorMessage": null,
  "errorCode": 0,
  "refundConfirmation": "063-LlgKAzfRL",
  "approvedBy": "PayPal",
  "refundBy": "PayPal",
  "dateApproval": "2019-12-19T09:47:59.105Z",
  "result": "Approved",
  "providerId": "z+n1opZ+RFn50fstklvWoOsovKIY5AUfsrVdGsO653c=",
  "transaction": {
    "TransactionNumber": "14a4334a32c852aeb0cfae52cbff1314649da7f175a8e140b35c147c",
    "date": "2019-12-19T09:47:59.105Z",
    "amount": 1234.56,
    "currency": "USD",
    "status": 0,
    "businessId": 144
  }
}

Example of Unsuccessful Refund

{
    "errorMessage": "refund operation declined by Processor",
    "errorCode": 22,
    "transaction": null,
    "refundConfirmation": null,
    "dateApproval": null,
    "result": "Declined",
    "providerId": null,
    "approvedBy": null,
    "refundBy": null,
    "amount": null
}

Refund Request Examples

Basic request example to refund a new transaction using Device ID:

{
  "transactionNumber": "14a4334a32c852aeb0cfae52cbff1314649da7f175a8e140b35c147c",
  "deviceId": "2ooeww5ufzg3nkuf8a10gu5n695yolixlbgb042o03to9bxfkr7t815i5epu8o58jv1rznif3o1tr6xsb1rm"
}

Basic request example to refund a new transaction using Location API Key or Merchant API key:

{
  "transactionNumber": "14a4334a32c852aeb0cfae52cbff1314649da7f175a8e140b35c147c",
  "apiKey": "2ooeww5ufzg3nkuf8a10gu5n695yolixlbgb042o038o58jv1rznif3o1tr6xsb1rm"
}

Flow Chart

See our payment flow chart here

Transaction Status Flow

See our transaction status flow here

Terminal Agent expose synchronous payment request call that reduce the integration time and logics.

Usage Flow:

1. Call POST request to: http://localhost:8003/api/transactions/init/sync Use the same schema as - Create a transaction

2. DeviceId field is not required - Terminal agent will append it automatically

3. Cancelling the payment request can be done using cancelling the HTTP request from #1

4. On final result (Approve, timeout or Cancel) - you will get response to this request

Example

URL: http://localhost:8003/api/transactions/init/sync

Request Body:

{
    "amount": 100,
    "timeOut": 500,
    "currency": "USD",
    "isCent": true
} 

Response body:

{
    "TransactionNumber": "1dde6de24cb4b96678517350c075a3e89a4103ed3132b3444ee055ed",
    "date": "2024-04-17T19:50:33.588Z",
    "amount": "1",
    "baseAmount": "1",
    "currency": "USD",
    "status": 5,
    "statusName": "Transaction Approved",
    "timeoutDate": "2024-04-17T19:58:53.820Z",
    "maxInstallments": 1,
    "reason": null,
    "paymentCommit": {
        "messsage": "Please Commit this payment in 7200 seconds",
        "secondsToCommit": 7200,
        "commitLink": "https://api.sandbox.sensepass.com/api/transactions/commitPayment/1dde6de24cb4b96678517350c075a3e89a4103ed3132b3444ee055ed"
    },
    "methodType": 0,
    "businessId": "91878198955101",
    "businessName": "SensePass",
    "pos": "SensePass",
    "businessOwnerPhone": "113654",
    "businessCountry": "USA",
    "businessCity": "A",
    "businessState": "B",
    "businessStreet": "NY",
    "businessAddress": "NY",
    "locale": {
        "language": "en"
    },
    "products": [],
    "productsSum": {
        "allAmountSum": "0.00",
        "allTipSum": "NaN",
        "allVatSum": "0.00",
        "allTotalSum": "0.00",
        "allDiscountSum": "0.00",
        "allDiscountedAmountSum": "0.00"
    },
    "paymentProcessRequestID": "5330731519",
    "confirmation": {
        "approvedBy": "Shift4 Sandbox",
        "dateApproval": "2024-04-17T19:50:44.964Z",
        "approvalDate": "2024-04-17T19:50:44.964Z",
        "paymentType": "Regular",
        "sensePassReferenceId": "d4t9xyubad5geoj1c2yc",
        "paymentMethodName": "Credit Card (Sensepass PCI)",
        "providerId": "bmU4Ip5koVvi8harpkh5WW50BEQj7FpdNJhWkTMEbqQ=",
        "authNumber": null,
        "acquirer": null,
        "voucher": null,
        "referenceNumber": null,
        "requestID": "5330731519",
        "amount": 1,
        "confirmationNumber": "297-OK522Z",
        "fullConfirmationCode": "297-OK522Z",
        "providerName": "Shift4 Sandbox",
        "cardType": "VISA",
        "lastFourDigits": "1111",
        "cardMask": "411111******1111",
        "expiration": "1234",
        "cardExpiration": "1234",
        "installments": 1,
        "paymentMethod": "Credit Card",
        "Credit Card": {
            "cardType": "VISA",
            "lastFourDigits": "1111",
            "mask": "411111******1111",
            "expiration": "1234"
        },
        "extraDetails": {
            "email": null
        }
    },
    "confirmationNumber": "297-OK522Z",
    "confirmations": [
        {
            "approvedBy": "Shift4 Sandbox",
            "dateApproval": "2024-04-17T19:50:44.964Z",
            "approvalDate": "2024-04-17T19:50:44.964Z",
            "paymentType": "Regular",
            "sensePassReferenceId": "d4t9xyubad5geoj1c2yc",
            "paymentMethodName": "Credit Card (Sensepass PCI)",
            "providerId": "bmU4Ip5koVvi8harpkh5WW50BEQj7FpdNJhWkTMEbqQ=",
            "authNumber": null,
            "acquirer": null,
            "voucher": null,
            "referenceNumber": null,
            "requestID": "5330731519",
            "amount": 1,
            "confirmationNumber": "297-OK522Z",
            "fullConfirmationCode": "297-OK522Z",
            "providerName": "Shift4 Sandbox",
            "cardType": "VISA",
            "lastFourDigits": "1111",
            "cardMask": "411111******1111",
            "expiration": "1234",
            "cardExpiration": "1234",
            "installments": 1,
            "paymentMethod": "Credit Card",
            "Credit Card": {
                "cardType": "VISA",
                "lastFourDigits": "1111",
                "mask": "411111******1111",
                "expiration": "1234"
            },
            "extraDetails": {
                "email": null
            }
        }
    ],
    "balance": 1,
    "paymentMethodImages": {},
    "clientPhoneNumber": null,
    "clientEmail": null
}

Updating transaction amount

Flow:

1. The transaction must be created with "readyForPayment": false flag first

2. The customer can see the transaction page and can't choose any payment method

3. The platform calls PATCH API to update transaction details including "amount" field, this API can be invoke multiple times

4. The platform calls PATCH API with "readyForPayment" = true , which allows the customer to choose a payment method and pay - without having to refresh the page or tap again

This flow is useful for POS who would like to create an initial transaction object with zero amount and update the total amount and other fields during the products scanning proccess, or any other flow where there is a requirement to create transaction once, and update it's amount and data later.

Step 1 - Creating a transaction in Setup state

POST

https://api.sandbox.sensepass.com/api/transactions/init

{
    "amount": 100,
    "currency": "USD",
    "isCent": true,
    "readyForPayment": false,
    "deviceId": "YOUR-DEVICE-ID"
} 

Step 2 - Updating transaction Data

PATCH

https://api.sandbox.sensepass.com/api/transactions/250b859e1fb5b162d476f67dcc9ef9f0e2cb3a9412d13a610412d769

{
    "amount": 550,
    "currency": "USD",
    "isCent": true,
    "deviceId": "YOUR-DEVICE-ID",
    "products": [
      {
        "name": "Shirt",
        "quantity": 1,
        "amount": 190,
        "discount": 0,
        "vat": 0
      },
      {
        "name": "Service Fee",
        "quantity": 1,
        "amount": 10,
        "discount": 0,
        "vat": 0
      }
    ]
} 

Step 3 - Allowing user to make payments

PATCH

https://api.sandbox.sensepass.com/api/transactions/250b859e1fb5b162d476f67dcc9ef9f0e2cb3a9412d13a610412d769

{
    "amount": 550,
    "currency": "USD",
    "isCent": true,
    "deviceId": "YOUR-DEVICE-ID",
    "products": [
      {
        "name": "Shirt",
        "quantity": 1,
        "amount": 190,
        "discount": 0,
        "vat": 0
      },
      {
        "name": "Service Fee",
        "quantity": 1,
        "amount": 10,
        "discount": 0,
        "vat": 0
      }
    ],
    "readyForPayment": true
} 

Updating transaction fields

The following fields can be updated using the PATCH method based on Transaction Entity:

1. reason

2. products

3. posData

4. metadata

5. clientPhoneNumber

6. clientEmail

7. readyForPayment

Example

PATCH

https://api.sandbox.sensepass.com/api/transactions/250b859e1fb5b162d476f67dcc9ef9f0e2cb3a9412d13a610412d769

{
  "reason": "New Reason",
  "posData": {
    "a": "b"
  },
  "metadata": {
    "x": "y"
  },
  "deviceId": "YOUR-DEVICE-ID"
}

Terminal Agent is a SensePass software designed to connect platforms to SensePass network with a range of EMV pinpads and to simplify the integration process, allowing for quick setup and deployment.

Terminal Agent also works as a proxy to all SensePass cloud API describes in this portal.

In addition, Terminal agent allows you to use specific API's created for the Terminal Agent software to reduce the integration time.

Advantages:

1. Pairing of tags and EMV devices is already implemented

   Terminal Agent handles the pairing process for all types of terminals and tags using SensePass UI

2. Storing API keys, Device ID's and EMV ID's is already implemented

   Terminal Agent stores all the credentials and authentication keys and append them automatically to all of your requests

3. Implementing Web-sockets or Callback endpoint is already implemented

   Terminal Agent internal logic works with Socket.IO websockets securely, according to SensePass interface and returns synchronous response to your platform

4. Integrating using Terminal Agent enables you to support new features and releases without any change on your end

   Most of the new features that will be released to our API will be available to you seamlessly by updating the Terminal Agent software on the POS, without having to change one line of code on your platform

5. Integration with the Cancel API is already implemented

   Terminal Agent detects the cancel event of the HTTP request for Synchronous Payment API and calls internally to the "Cancel" API in order to revoke the pending payment request

6. Realtime product update already implemented for EMV Pinpad and SensePass tags Terminal Agent detects product update API calls and creates a "Setup" transaction with the product information, once the POS is ready to accept a payment - an "Init" call should be sent as usual without any additional params. Terminal Agent detects the relation between the previous "Setup" transaction and makes all the API calls transparently.

7. Terminal Agent software is already certified by SensePass

   Integration using Terminal Agent reduces most of the certifcation process for your platform

System Requirements: Operating System: Compatible with Windows 7, 8, 10, and newer versions.

Synchronous payment request

Terminal Agent expose synchronous payment request call that reduce the integration time and logics.

Usage Flow:

1. Call POST request to: http://localhost:8003/api/transactions/init/sync Use the same schema as - Create a transaction

2. DeviceId field is not required - Terminal agent will append it automatically

3. Cancelling the payment request can be done using cancelling the HTTP request from #1

4. On final result (Approve, timeout or Cancel) - you will get response to this request

See full docs about sync payment request

Last Transaction Status

Terminal Agent expose an API to recover from network issue while using the Sync payment API,

in event of error or closed connection, you can use this API to fetch the current status of the last transaction created.

Usage Flow:

1. Call GET request to: http://localhost:8003/api/transactions/last Without any request payload

2. DeviceId field is not required - Terminal agent will append it automatically

3. Reponse will return immediately according to Transaction Status schema

See full docs about last transaction status API

Terminal Agent Key Features

• Reduces the intergation time: Pairing, cancelling request and working with websockets logics are already embeded inside terminal agent

• Compatibility with Various Pinpads: Terminal Agent supports a wide array of EMV pinpad models and manufacturers, enhancing its utility in diverse environments.

• Easy Integration: Designed for effortless setup, enabling quick deployment across multiple terminals.

• Real-time Monitoring: Ensures continuous operation with live monitoring capabilities.

• Automatic Updates: Keeps the system up-to-date with the latest features and security patches without manual intervention.

This model represents subscription method type & its related data for a new transaction creation.

Subscription Model

This model is referenced in the "subscription" field of the Transaction Model object.

This model is referenced in "inputs" field of Customer Input request body

Subscription is the process of recurring payments by a interval.

Subscription is useful for charging consumers a fixed sum of money, e.g. $10.99 per month, or any kind of future payments with a chosen sum.

Create a Subscription

POST https://api.sensepass.com/api/transactions/init

Request Body

{
    "TransactionNumber": "5f3275249792ee75b41322e636617ee039e2e1a49cc80c11f2177233",
    "date": "2022-08-14T10:09:05.810Z",
    "status": 0,
    "statusName": "Initialize",
    "timeoutDate": "2022-08-14T10:19:05.872Z",
    "paymentCommit": {
        "messsage": "Payment commit is enabled for this transaction"
    },
    "businessId": "339978940107456",
    "businessName": "Coffee Bar",
    "pos": "POS 1",
    "businessOwnerPhone": "3587292",
    "businessCountry": "US",
    "businessCity": "Virginia Beach",
    "businessStreet": "123 Street",
    "businessAddress": "123 Street, Virginia Beach",
    "branchNumber": "1",
    "branchId": "1",
    "subscription": {
        "id": "bf8b7e01-466d-4996-b9a2-fc0880923359",
        "active": true,
        "created": "2023-05-30T14:35:13.698Z",
        "updated": "2023-05-30T14:35:13.698Z",
        "expires": null,
        "start_date": "2023-01-01T12:00:00.000Z",
        "interval": "1month",
        "status": "active",
        "customer": {}
    },
    "transactionPage": {
        "iOSLink": "https://pay.sandbox.sensepass.com/orderSummary/5f3275249792ee75b41322e636617ee039e2e1a49cc80c27f2177233",
        "androidLink": "https://pay.sandbox.sensepass.com/orderSummary/5f3275249792ee75b41322e636617ee039e2e1a49cc80c27f2177233",
        "qrURL": "https://pay.sandbox.sensepass.com/orderSummary/5f3275249792ee75b41322e636617ee039e2e1a49cc80c27f2177233"
    }
}

Quick demo

Check out our demo page to see the flow in action.

Configuration

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>SensePass Elements SDK</title>
    <!-- Set the SensePass SDK script -->
    <script src="https://js.sensepass.com/scripts/[email protected]"></script>
</head>
<body style="width: 25rem; margin: 0 auto">
    <!-- Top Payment Button -->
    <button id="primary-payment-button" onclick="handlePaymentButtonClick()">Complete Payment (primary)</button>
    <!-- SensePass Elements Container -->
    <div id="sensepass-front-end"></div>
    <!-- Bottom Payment Button -->
    <button id="secondary-payment-button" onclick="handlePaymentButtonClick()">Complete Payment (secondary)</button>
    <script>
        // Configure the SDK
        const spClient = SensePassFrontEndSDK.config({
            mode: "sandbox", // "sandbox" | "production"
            debug: true,
            clientId: "SensePassSDKGeneralClientId",
            methodType: "manual_capture", // "manual_capture" | "authorize" | "tokenize"
            theme: {
                paymentMethodGrid: "vertical" // "horizontal" | "vertical" | "vertical-b"
            },
            payButtonId: ['primary-payment-button', 'secondary-payment-button'], // Array of button IDs
        });
        // Initialize the SDK
        const sensepass = spClient.init();
        // Event: Payment method selected
        sensepass.paymentSelected(payload => console.log('Payment method selected:', payload));
        // Event: Payment in progress
        sensepass.paying(payload => console.log('Payment in progress:', payload));
        // Event: Payment method validation status
        sensepass.paymentMethodValidationStatus(payload => console.log('Payment validation status:', payload));
        // Event: Error occurred
        sensepass.error(payload => console.error('SDK Error:', payload));

        function handlePaymentButtonClick() {
            // Call the pay method when button is clicked
            sensepass.pay(payload => console.log('Payment result:', payload),
                {
                    amount: 1299, // Amount in cents (12.99 USD)
                    currency: "USD",
                    billingAddress: {
                        city: "New York",
                        email: "[email protected]",
                        firstName: "John",
                        lastName: "Doe",
                        street: "123 Demo St",
                        state: "NY",
                        zipcode: "10001",
                        mobilePhone: "5551234567",
                        country: "US"
                    }
                }
            );
        }
    </script>
</body>
</html>

Payment Data

{
  "TransactionNumber": "7f943e53476a3efcc263d0f975a01c45a6118fc55852efde8dad7227",
  "status": 20
}

Customization

SensePassFrontEndSDK.config({
   // ...,
   theme: { // optional theme for various packages
	/** angular material provides extensive documentation on customizing their theme
	* you can find it at: https://material.angular.io/guide/theming */
	material: "https://pay.sandbox.sensepass.com/publicAssets/themes/custom-sample-material.theme.css", // sample for a customized material theme
	sensepassEcommerce: "https://pay.sandbox.sensepass.com/publicAssets/themes/custom-sample-ecommerce.theme.css", // sample for a customized sensepass theme
	paymentMethodGrid: "horizontal", // horizontal | vertical style of the payment options
	config: {} // a configuration object for specific payment methods text/animations
   }
})

E-commerce iFrame is useful for e-commerce website - the website displays the iFrame as part of the checkout page to enable customer to pay with multiple payment methods.

This iFrame enables fast integration to any website with minimal coding and enables you to get SensePass updates and new features seamlessly.

Flows supported

1. Capture, Authorization and Tokenization payment types

2. Products summary

3. Receipt

4. Invoice

5. Manual Capture

6. JS post message events, see our docs here

7. Callback events, see our docs here

8. Socket.IO events, see our docs here

Supported Payment Methods

All SensePass payment methods, see here the full list

Usage

1. Create a transaction

2. From the create trasnaction API - get the value of transactionPage.consumerPage

Regular display

transactionPage.consumerPage.regular for full size view

Medium display

transactionPage.consumerPage.medium

Medium view without the QR

Small display

transactionPage.consumerPage.small

Smaller view without the QR and without the header

Please see our full documentation and examples for e-commerce iFrame

This model represents all the required data for displaying data on the SensePass Dashboard backoffice.

// metadata must be an array of objects with key-value pairs
"metadata": [
    {
        // mandatory static key-value - do not change this
        "key": "genericDisplay",
        // array of your sections
        "value": [
            {
                // your title for the section
                "sectionLabel": "Hello world",
                "values": [
                    {
                        "label": "Foo",
                        "value": "Bar"
                    },
                    ...// the rest of the label-value object pairs
                ]
            },
            ...// the rest of the sectionLabel-values object pairs
        ]
    }
]

Metadata Model

This model is referenced in "metadata" parameter of request body

Update the subscription item to pause, resume or cancel its due payments.

Status

These are the available values for the status parameter in the request body.

Update subscription's status

PATCH https://api.sensepass.com/api/subscription/:subscriptionUid

available status values are: active, paused, canceled

Path Parameters

Headers

Request Body

Terminal Agent expose an API to recover from network issue while using the,

in event of error or closed connection, you can use this API to fetch the current status of the last transaction created.

Usage Flow:

1. Call GET request to: http://localhost:8003/api/transactions/last Without any request payload

2. DeviceId field is not required - Terminal agent will append it automatically

3. Reponse will return immediately according to schema

Example

URL: http://localhost:8003/api/transactions/last

Response body:

API to credit (transfer money from merchant to customer) by credit card token.

Token can be created using the .

API Interface

Credit API

POST https://api.sensepass.com/api/transactions/credit

Request Body

Authentication Request Body fields

Example

Basic request example to credit $1.23 using Device ID:

Basic request example to credit $100.01 using Location API Key or Merchant API key:

Flow Chart

Transaction Status Flow

Post messsge events are sent to client side using the browser API.

Code example:

Payload Example - Approved Transaction

Payload Example - Cancelled Transaction

API for retrieving input from consumer using SensePass Tags and EMV devices.

API Interface

Get customer input

POST https://api.sensepass.com/api/transactions/customer-input

For terminal agent invoke use this endpoint: http://localhost:8003/api/transactions/customer-input

Request Body

Example - Simple Questions

Example - Yes/No Questions

Clear all questions on device

Clear customer input

POST https://api.sensepass.com/api/transactions/customer-input/reset

For terminal agent invoke use this endpoint:

http://localhost:8003/api/transactions/customer-input/reset

Request Body

Credit Card iFrame enables you to display iFrame in your checkout page or in your POS software in order to get sensitive credit card details without having to certify your website or software to PCI.

SensePass are PCI Level 1 certified.

Flows supported

1. Capture

2. Tokenization

3. Authorization

Usage

2. From the create transaction API - get the value of transactionPage.merchantPage.creditCard.default

3. Show the page using iFrame and listen for post message events or callback, see here

Example of Transaction Response

This model represent the full details about the items in the ticket including sub-products.

Product Model

This model referenced in "products" field of request body

This model represents customer shipping/billing details that the merchant/platform shares with SensePass in order for SensePass to send this information to the payment methods to simplify the payment flows without having the consumer to type this information.

Shipping/Billing Model

This model is referenced in the "billingAddress" field and "shippingAddress" field of the Creating a transaction.

There are multiple options to get notifications about the transaction status changes:

1. Callback

2. Web sockets (Socket.IO)

3. Post message event on the client side

Notifications Interface

All of the notifications are conforms to Transaction Entity interface.

See the full interface model here:

Notification Example:

{
  "TransactionNumber": "14a4334a32c852aeb0cfae52cbff1314649da7f175a8e140b35c147c",
  "date": "2019-12-19T09:47:59.105Z",
  "amount": 1234.56,
  "currency": "ILS",
  "status": 0,
  "statusName": "Transaction Approved",
  "pos": "POS 3, Branch Tel Aviv",
  "posReceiptsEndpoint": "http://pay.sensepass-api.com/api/invoicesReceipts/receipt/save/hofai3478o8o78o4s849j3920ckj",
  "posData": {
    "foo": "bar",
    "hello": [
      "world"
    ]
  },
  "businessName": "Coffee Bar",
  "businessId": 144,
  "timeoutDate": "2019-12-19T09:47:59.105Z",
  "paymentMethodData": {
    "PaymentType": "Bit",
    "directAppLinks": {
      "iOSLink": "paymentsBIT://www.bitpay.co.il/app/bitcom-info",
      "androidLink": "intent://www.bitpay.co.il/app/bitcom-info;scheme=bit;package=com.bnhp.payments.paymentsapp;end",
      "qrURL": "https://www.bitpay.co.il/app/bitcom-info"
    }
  },
  "SMS": "Sent",
  "paymentCommit": {
    "messsage": "Payment commit is enabled for this transaction",
    "isPaymentCommitted": false,
    "secondsToCommit": 60,
    "commitLink": "https://pay.sensepass-api.com/api/transactions/commitPayment/ec2dc489d161aa27a803f48bcf5ffcf"
  },
  "products": [
    {
      "name": "Coffee",
      "quantity": 2,
      "amount": 100,
      "discount": 0,
      "posIdentifier": "1234A"
    },
    {
      "name": "Beer",
      "quantity": 1,
      "amount": 600,
      "discount": 0,
      "posIdentifier": "1234B"
    }
  ],
  "confirmations": [
    {
      "paymentType": "Regular",
      "confirmationNumber": "063-d9j09YsY1",
      "fullConfirmationCode": "063-d9j09YsY1",
      "dateApproval": "2019-12-19T09:47:59.105Z",
      "installments": 1,
      "paymentMethodName": "PayPal",
      "approvedBy": "PayPal",
      "providerId": "uGfNuwEGiP18SUnTUEo1/atTdesDnhDhZ/8i7G9NAEg=",
      "requestID": "a4dbf66e-d3f1-4a29-baf7-2591424a9a0c",
      "authNumber": "123213dsf13111",
      "referenceNumber": "1778298289",
      "acquirer": "Visa",
      "voucher": "yyyAbnlmlfm1323",
      "lastFourDigits": "8858",
      "sensePassReferenceId": "34e209ea8b24cc831cf",
      "settlement": {
        "status": 2, // 0=processing, 1=pending, 2=done
        "created": "2019-12-19T09:47:59.105Z", // will be updated upon status change
        "confirmation": "091239831" // only exists once status = 2 (done)
      }
    }
  ],
  "confirmation": {
    "paymentType": "Regular",
    "confirmationNumber": "063-d9j09YsY1",
    "fullConfirmationCode": "063-d9j09YsY1",
    "dateApproval": "2019-12-19T09:47:59.105Z",
    "installments": 1,
    "paymentMethodName": "PayPal",
    "approvedBy": "PayPal",
    "providerId": "uGfNuwEGiP18SUnTUEo1/atTdesDnhDhZ/8i7G9NAEg=",
    "requestID": "a4dbf66e-d3f1-4a29-baf7-2591424a9a0c",
    "authNumber": "123213dsf13111",
    "referenceNumber": "1778298289",
    "acquirer": "Visa",
    "voucher": "yyyAbnlmlfm1323",
    "lastFourDigits": "8858",
    "sensePassReferenceId": "34e209ea8b24cc831cf",
    "settlement": {
      "status": 2, // 0=processing, 1=pending, 2=done
      "created": "2019-12-19T09:47:59.105Z", // will be updated upon status change
      "confirmation": "091239831" // only exists once status = 2 (done)
    }
  },
  "transactionPage": {
    "iOSLink": "https://mbeta.sensepass-api.com/orderSummary/027e4e48d59fdbe83f5a78cab62a53c676b7f111fa9d0ee0a36d1872",
    "androidLink": "https://mbeta.sensepass-api.com/orderSummary/027e4e48d59fdbe83f5a78cab62a53c676b7f111fa9d0ee0a36d1872",
    "qrURL": "https://mbeta.sensepass-api.com/orderSummary/027e4e48d59fdbe83f5a78cab62a53c676b7f111fa9d0ee0a36d1872"
  },
  "balance": 0
}