MoneyInPayTrailInit: Initialize PayTrail Payment

Version

Description

1.0


How it works

You will need 2 integration points on your code:

  • One call to DirectKit to init PayTrail payment to credit the wallet
  • One redirection from your website to the return URL by PayTrail

Please refer to Finalize PayTrail Transaction

Request

  

XML

<MoneyInPayTrailtInit xmlns="Service_mb">
  <wlLogin>string</wlLogin>
  <wlPass>string</wlPass>
  <language>string</language>
  <version>string</version>
  <walletIp>string</walletIp>
  <walletUa>string</walletUa>
  <wallet>string</wallet>
  <wkToken>string</wkToken >
  <amountTot>string</amountTot>
  <amountCom>string</amountCom>
  <comment>string</comment>
  <returnUrl>string</returnUrl>
  <autoCommission>string</autoCommission>
</MoneyInPayTrailtInit >

JSON

{   
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "wkToken":"string",
    "amountTot":"string",
    "amountCom":"string",
    "comment":"string",
    "returnUrl":"string",
    "autoCommission":"string"
}

Item

Description

Mandatory

Format

Example

wallet

Wallet ID to credit

Yes

[0 : 256] char

33612345678 ou taxi67

wkToken

Unique ID of the call created by your server that will be used returned by Lemonway at the end of the operation, using a POST on your URL

Yes

[1 : 50] char

5652772

amountTot

Amount to debit

Yes

2 decimals

15.00

amountCom

Your fee

No

2 decimals

1.00

comment

Comment regarding the transaction

No

[0 :140] char

Order number 2457765AX2

returnUrl

Your return URL, called by iDeal to terminate the operation and on which the callback will be sent, with data in POST parameters. 
This URL must contain a unique ID so you know which operation is related to the return.

Yes

[1 : max] char

https://www.yoursite.com/payment_return.php/?id=367GBD

autoCommission

Indicate if a fee is taken directly from the amount to pay.
If Yes: [amount] is debited, and creditWallet receives [amount-Lemonway fee] 
Else amountCom value is used

Yes

[1] char

0: No (by default) 
1: Yes

Answer


XML

<?xml version="1.0" encoding="utf-8"?>
<PAYTRAILINIT>
	<ID>String</ID>
	<actionUrl>String</actionUrl> 
</PAYTRAILINIT>
  

JSON

{  
    "PAYTRAILINIT":{  
        "ID":"String",
        "actionUrl":"String"
    }
}

Item

Description

Example

ID

ID of the transaction. You will this value to confirm the transaction

589

actionUrl

Redirect URL for the CLIENT on the PayTrail page payment

https://payment.paytrail.com/payment/load/token/9jt1D3SeQYZhirUAKvAgHppxPvJqLGYC1rB7XAj5svkVYeanSydHi7ZTzvMVaRAz