API Reference

Server response

Updating the server with the transaction's status and details would be performed by an HTTPS API method that you will be providing us when calling to create a payment process, in the notifyUrl param.

This URL is an endpoint in your site, which Grow's server will call to update you about the transaction. When received this call (you could save data to DB etc. and then) you should call ApproveTransaction.

The method takes in parameters as an HTTP POST, the same way as you would send the data to the CreatePaymentProcess method and NOT as JSON.

Please note: The payment will go through even if you did not Approve Transaction.

  {
        "err": "",
        "status": "1",
        "data": {
            "cardSuffix": "3113",
            "cardType": "Local",
            "cardTypeCode": "1",
            "cardBrand": "Visa",
            "cardBrandCode": "3",
            "cardExp": "1123",
            "firstPaymentSum": "0",
            "periodicalPaymentSum": "0",
            "status": "עסקה מושהית",
            "statusCode": "11",
            "transactionTypeId": "1",
            "paymentType": "2",
            "sum": "1",
            "paymentsNum": "1",
            "allPaymentsNum": "1",
            "paymentDate": "18/10/23",
            "description": "תיאור",
            "fullName": "בדיקה GROW",
            "payerPhone": "0500000000",
            "payerEmail": "",
            "cardToken": "599d3acF5F5F5F5F5671849845064b9",
            "transactionId": "287313",
            "transactionToken": "34a0eF5F5F5F0a9ac40709b69",
            "processId": "462904",
            "processToken": "bdd1fbd80F5F5F5F6bcc073a16"
        }
    }
  • status is referred to success or failure (1 or 0 respectively).
  • err - in case of an error, would return as the error code and error message.
  • data - all the details would return here.

Test

If you wish to test this call you can use updateMyUrl function.

This is a Get function that simulates our server-to-server call. You need to insert your server address in the URL.

This will help you debug the service, and/or insert logs if necessary.

https://sandbox.meshulam.co.il/api/light/server/1.0/updateMyUrl/?url=MySiteURL