User Tools

Site Tools


simplemt

This is an old revision of the document!


SimpleMT

Simple API for MoneyPolo money transfers



Service address

Test web service address (for testing purposes) https://testapi.moneypolo.com:26443/SimpleMT.asmx

Real web service address https://api.moneypolo.com:26442/SimplemT.asmx

Please note, that test and prod keys are different from each other. Working key will be issued by MoneyPolo company at the end of the testing period.



Security

Every transmitted request must be signed by the secret key. Issuance of the key by the company MoneyPolo to the Client is performed at the beginning of testing. The key is changed at the transfer to the production version of the service.



Request format

All the requests to the service are sent by standard tools by means of the SOAP webservice.

ATTENTION! Any response of the system may be considered successful only if the object of the response does not contain errors!



Methods

SimpleMTByChannel

Call this method to create transaction

Request parameters:

Name Type Description
MerchantTransactionID string Remote Transaction ID - unique identificator for transaction on the merchant side). Used as transfer number in some cases.
Amount UInt32
CurrencyCode string Currency of transaction (multiplied by CurrencyExponent)
CurrencyExponent UInt32 Currency exponent (Example, transaction for 100 EUR, Amount * pow(10, Exp) = 10000, Exp = 2)
SenderFirstName string
SenderLastName string
SenderBirthDate string YYYY-MM-DD
SenderDocumentNumber string
SenderDocumentIssueDate string YYYY-MM-DD
SenderDocumentAuthority string
SenderCitizenship string 2-char Country Code
SenderResidenceCountry string 2-char Country Code
SenderAddress string
SenderPhone string
ReceiverFirstName string
ReceiverLastName string
ReceiverMiddleName string
ReceiverPhone string
SendPoint string required for some channels, will be provided to merchant by MoneyPolo in this cases
RequestID string for internal use, leave empty
ChannelCode string UA for Ukraine direction, AZ for Azerbaijan, PL for Poland
PayoutTypeCode string “CASH” or “BANK”, by default CASH is assumed
PayoutBankName string
PayoutBankAccountNumber string
PayoutBankBranch string
PayoutBankBranchCode string

Request signature hash structure:

MerchantTransactionID + Amount + CurrencyCode + CurrencyExponent +
SenderFirstName + SenderLastName + SenderBirthDate +
SenderDocumentNumber + SenderDocumentIssueDate + SenderDocumentAuthority +
SenderCitizenship + SenderAddress + SenderPhone +
ReceiverFirstName + ReceiverLastName + ReceiverMiddleName + ReceiverPhone +
SendPoint + RequestID + ChannelCode + 
PayoutTypeCode + PayoutBankName + PayoutBankAccountNumber + PayoutBankBranch + PayoutBankBranchCode + *key

Response parameters:

Name Type Description
Success bool true/false as result of request
RequestID int Unique internal identifier of the request in the transfer system MoneyPolo
TransferNumber string TransferNumber of transaction created by request. in most cases it is equal to MerchantTransactionID.
PayoutCurrency string Payout currency code (important if PL channel only)
PayoutAmount decimal Payout amount (important if PL channel only)
PayoutRate decimal Payout currency exchange rate (important if PL channel only)



SimpleMTChange

Call this method to change the receiver of transaction

Request parameters:

Name Type Description
MerchantTransactionID string Remote Transaction ID - unique identificator for transaction on the merchant side). Used as transfer number in some cases.
RequestID string ID of transaction returned by CreateByChannel method
ReceiverFirstName string
ReceiverLastName string
ReceiverMiddleName string
ReceiverPhone string

Request signature hash structure:

MerchantTransactionID + RequestID + 
ReceiverFirstName + ReceiverLastName+ ReceiverMiddleName+ ReceiverPhone+ *key

Response parameters:

Name Type Description
Success boolean Success/Fail flag
Status string Status of the transaction



SimpleMTGetStatus

Call this method to status of transaction

Request parameters:

Name Type Description
MerchantTransactionID string Remote Transaction ID - unique identificator for transaction on the merchant side). Used as transfer number in some cases.
RequestID string ID of transaction returned by CreateByChannel method

Request signature hash structure:

MerchantTransactionID + RequestID + *key

Response parameters:

Name Type Description
Status string Status of the transaction
AutoReturnIsPossible string 0/1. in case of 0, return is still possible, but via contacting support



SimpleMTCancel

Call this method to cancel transaction

Request parameters:

Name Type Description
MerchantTransactionID string Remote Transaction ID - unique identificator for transaction on the merchant side). Used as transfer number in some cases.
RequestID string ID of transaction returned by CreateByChannel method

Request signature hash structure:

MerchantTransactionID + RequestID + *key

Response parameters:

Name Type Description
Status string Status of the transaction
simplemt.1504674567.txt.gz · Last modified: 2017/09/06 06:09 by Dmitry Karpenko