Get Details of a Completed Payment Form

GetCompletedPaymentForm

This function allows you to retrieve the status of a completed (or filled) payment form

Scenario

  • Using the CreatePaymentForm function, you generated a re-usable Payment Form (with the form ID for example 579c7def4bb0411da294d9b57c2c1323)
  • Some clients fill out the form and make payments.
  • Each time a client completes the form and clicks on the "Accept and Pay" button, LemonWay will store the completed form and generate a new id for it, for example, 7e98be392a5e45f6bc357a9ab8c623d2
  • The initial status of the "completed form" is PENDING. When the client finishes the payment process, it will switch to PAID. It could also switch to CANCEL or ERROR..

In this example, the completed form 7e98.. was created from the parent form 579c.. Form 579c.. is reusable, which means it can be completed several times by different clients, so it could have many completed versions.

This function allows you to retrieve the status of a filled form via its id (7e98..).

XML

<GetCompletedPaymentForm xmlns="Service_mb">
  <wlLogin>string</wlLogin>
  <wlPass>string</wlPass>
  <language>string</language>
  <version>string</version>
  <walletIp>string</walletIp>
  <walletUa>string</walletUa>
  <formId>string</formId>  
</GetCompletedPaymentForm>
<SetPaymentFormStatusResult xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="Service_mb_xml">
     <form>
         <id>string</id>
         <optId>string</optId>
         <parentId>string</parentId>
         <parentComment>string</parentComment>
         <walletPayer>string</walletPayer>
         <walletReceiver>string</walletReceiver>
         <amountTot>string</amountTot>
         <comment>string</comment>
         <firstNamePayer>string</firstNamePayer>
         <lastNamePayer>string</lastNamePayer>
         <emailPayer>string</emailPayer>
         <status>PENDING | PAID | ERROR | CANCEL</status>
         <utcdate>2016-09-20 14:58:09Z</utcdate>
         <created>2016-09-19 15:09:12Z</created>
         <returnUrl>string</returnUrl>
         <cancelUrl>string</cancelUrl>
         <errorUrl>string</errorUrl>
     </form>
</SetPaymentFormStatusResult>

JSON

{
    "wlLogin": "string",
    "wlPass": "string",
    "language": "string",
    "version": "string",
    "walletIp": "string",
    "walletUa": "string",
    "formId": "string",
}
{
    "form": {
        "id": string,
        "optId": string,
        "parentId": string,
        "parentComment": string,
        "walletPayer": string,
        "walletReceiver": string,
        "amountTot": string,
        "comment": string,
        "firstNamePayer": string,
        "lastNamePayer": string,
        "emailPayer": string,
        "status": "PENDING | PAID | ERROR | CANCEL",
        "utcdate": string,
        "created": string,
        "returnUrl": string,
        "cancelUrl": string,
        "errorUrl": string,
    }

}
ParamsParamsParamsParamsParams
formIdPayment form Idyes327e98be392a5e45f6bc357a9ab8c623d2

Response

  • id is the completed form ID (7e98.. in our example).
  • parentId is the configuration form ID which you created with the CreatePaymentForm function (579c.. in our example).