Professional Documents
Culture Documents
Table of Contents
Chapter 1 1 Introduction
Chapter 2 1 API Revision History
Chapter 3 1 Details for connection
Chapter 4 2 API Methods
Chapter 5 2 Step0UserAuthenticate
3 GetAvaliableCountryList
5 GetAvaliableExchangeRates
6 GetAvaliablePaymentPointList
10 GetAvaliableRates
12 LoadInvoiceV001
17 GetInvoiceDetails
21 Error List
27 Status List
28 Events list
Introduction 1
I-TRANSFER GLOBAL PAYMENTS EP S.A. is a management company authorized to transfer money
abroad, as we have the means to get money either from offices, agents and correspondents, as well as the ability to
using automated electronic transmissions.
This document describes the usage for the Web Service interface between the ARGENPER's System
and I-TRANSFER GLOBAL PAYMENTS EP S.A. .Net Web Service.
Through this API, ARGENPER will be able to push the cash and bank transactions to I-TRANSFER
GLOBAL PAYMENTS EP S.A.'s System. We provide several examples in Visual Basic .Net which can be converts
other languages easily.
Using Web Services provides key advantages over others modes used, as Response Times and
Security.
URL: https://qa-api.i-transfer.net:13443/MTFROMAGENTTK.asmx
Documentación https://qa-api.i-transfer.net:13443/MTFROMAGENTTK.asmx?WSDL
WSDL:
Agent Name: ARGENPER
Agent Code: 10110
Agent Password: IT84208
TerminalID PC001
Note: You must provide to I-TRANSFER GLOBAL PAYMENTS EP S.A. your public IP in order to be authorize
Introduction 1
The Web service consists of six methods which are describe in detail in the next pages. The methods are:
Step0UserAuthenticate
GetAvaliableCountryList
GetAvaliableExchangeRates
GetAvaliablePaymentPointList
GetAvaliableRates
LoadInvoiceV001
GetInvoiceDetails
Field Properties:
M Mandatory Field
C Conditional Field
O Optional
Step0UserAuthenticate
Before performing any transaction, you must authenticate and obtain a token
RESPONS
E
FIELD DATA TYPE L REQ INFORMATION AND RULESNOTES
ReturnResult ReturnResult 1 R Ok or Error or NoData
ReturnCode integer 1 R Return code
ReturnDescri string 100 R Return description
ption
ReturnToken String 50 C Token is success case a8f5a221-c239- 466d-
b543-
67c785e149e0
EXAMPLE SOAP:
Dim REQ As New REFAGENTELITETK.EntityAuth REQ.EntityType = 3
REQ.EntityCode = 0 REQ.EntityLogin = "ARGENPER" REQ.EntityPass = "IT84208" REQ.TerminalID = "PC001"
Dim RES As New REFAGENTELITETK.AutorizationResponse
Dim WS As New REFAGENTELITETK.MTFROMAGENTTK
WS.Url = "https://qa-api.i-transfer.net:13443/MTFROMAGENTTK.asmx"
RES = WS.Step0UserAuthenticate(REQ)
If RES.ReturnResult = REFAGENTELITETK.ReturnResult.Ok Then 'RES.ReturnToken contiene el token que será usado para las siguiente
peticiones
Else
'RES.ReturnCode contiene el código de error 'RES.ReturnDescription contiene la descripcion del error
End If
EXAMPLE JSON:
Headers
UserFunction:CoGetAutorization
Request:
{"EntityType":3,"EntityCode":0,"EntityLogin":"ARGENPER","EntityPass":"IT84208","TerminalID":"PC001"}
Response:
{"ReturnResult":0,"ReturnCode":0,"ReturnDescription":"","ReturnToken":"a8f5a221-c239-466d-b543- 67c785e149e0"}
GetAvaliableCountryList
This method returns the list of countries available for ARGENPER.
REQUEST
Field Name DataType Required Information Description
Example
UserToken String M a8f5a221-c239- Token got from the
466d-b543- Step0UserAuthenti
67c785e149e0 cate
Country String O ISO3 Country Code.
Leave it blank to get
all countries
available.
RESPONSE
EXAMPLE SOAP:
EXAMPLE JSON:
Headers
UserFunction:GetAvaliableCountryList
Request:
{"UserToken":"a8f5a221-c239-466d-b543-67c785e149e0","Country":"BOL"}
Response:
{
"Result": 0, "Message": "", "DT": [
{
GetAvaliableExchangeRates
This method returns the exchange rates for the countries available for ARGENPER.
REQUEST
Field Name DataType Required Information Description
Example
UserToken String M a8f5a221-c239- Token got from the
466d-b543- Step0UserAuthenti
67c785e149e0 cate
RESPONSE
EXAMPLE SOAP:
GetAvaliablePaymentPointList
This method returns the list of payment points available for the countries enabled for ARGENPER.
REQUEST
RESPONS
E
Field Name DataType Information Result
Result ReturnResult OK | HasErrors | NoData
Message String If Result = HasErrors, shows the error description.
DT DataTable Datatable list with results
EXAMPLE SOAP:
"Pais": "BOL",
"Ciudad": "ANDRES IBAÑEZ",
"Direccion": "CALLE INGAVI Nº 166 A MEDIA CUADRA DE LA MANZANA 1", "MasDatos": "BANCO ECONOMICO - AG. PRESTO"
"Poblado": "5911553",
"Telefono1": "DOLARES, BOLIVIANOS",
"Telefono2": " ", "Retorno": 502037,
"HorarioLV": "L A V 9 A 16 / S 9 A 13", "HorarioS": "VENTANILLA",
"HorarioD": " ",
"Delegacion": " "
},
{
"Pais": "BOL",
"Ciudad": "ANDRES IBAÑEZ",
"Direccion": "CALLE INGAVI Nº 166 A MEDIA CUADRA DE LA MANZANA 1", "MasDatos": "[ECONOMICO PREMIUM] - AG. PRES
"Poblado": "SANTA CRUZ",
"Telefono1": " ",
"Telefono2": " ", "Retorno": 555962, "HorarioLV": " ",
"HorarioS": " ",
"HorarioD": " ",
"Delegacion": "MORE BOLIVIA/ECONOMICO PREMIUM"
},
{
"Pais": "BOL",
"Ciudad": "ANDRES IBAÑEZ",
"Direccion": "CALLE INGAVI Nº 166 A MEDIA CUADRA DE LA MANZANA 1", "MasDatos": "MORE - BANCO ECONOMICO - AG.
PRESTO",
"Poblado": "SANTA CRUZ",
"Telefono1": "(591) 33155500",
"Telefono2": " ", "Retorno": 556185, "HorarioLV": " ",
"HorarioS": " ",
"HorarioD": " ",
"Delegacion": "MORE BOLIVIA/BANCO ECONOMICO"
},
{
"Pais": "BOL",
"Ciudad": "BENI",
"Direccion": "AV. LA PAZ ESQ. SELIM MAJLUF N° 47 MZNO 040", "MasDatos": "MORE - FIE - AG. SAN BORJA",
"Poblado": " ",
"Telefono1": "+591 4 452 7555",
"Telefono2": " ", "Retorno": 502085, "HorarioLV": " ",
"HorarioS": " ",
"HorarioD": " ",
"Delegacion": "MORE BOLIVIA/FIE"
},
{
"Pais": "BOL",
"Ciudad": "BENI",
"Direccion": "AV. 25 DE MAYO ESQ. CALLE MARISCAL SANTA CRUZ, ZONA CENTRAL", "MasDatos": "804 - AGENCIA
GUAYARAMERIN - BNB - MORE",
"Poblado": "5911707",
"Telefono1": "DOLARES, EUROS, BOLIVIANOS",
"Telefono2": " ", "Retorno": 502105,
"HorarioLV": "L A V 9 A 16 / S 9 A 13", "HorarioS": "VENTANILLA",
"HorarioD": " ",
"Delegacion": " "
},
{
"Pais": "BOL",
"Ciudad": "BENI",
"Direccion": "AV. 25 DE MAYO ESQ. CALLE MARISCAL SANTA CRUZ, ZONA CENTRAL", "MasDatos": "804 - AGENCIA
GUAYARAMERIN - BNB - MORE",
"Poblado": " ",
"Telefono1": " ",
"Telefono2": " ", "Retorno": 505461,
"HorarioLV": "09H00 A 16H00", "HorarioS": "09H00 A 13H00",
"HorarioD": " ",
"Delegacion": "MORE MONEY EURO"
},
{
"Pais": "BOL",
"Ciudad": "BERMEJO",
"Direccion": "CALLE COCHABAMBA S/N, ENTRE AV. LA PAZ Y AV. BARRIENTOS", "MasDatos": "MORE - FIE - AG. BERMEJO",
"Poblado": "TARIJA",
"Poblado": " ",
"Telefono1": " ",
"Telefono2": " ", "Retorno": 505461,
"HorarioLV": "09H00 A 16H00", "HorarioS": "09H00 A 13H00",
"HorarioD": " ",
"Delegacion": "MORE MONEY EURO"
},
{
"Pais": "BOL",
"Ciudad": "BERMEJO",
"Direccion": "CALLE COCHABAMBA S/N, ENTRE AV. LA PAZ Y AV. BARRIENTOS", "MasDatos": "MORE - FIE - AG. BERMEJO",
"Poblado": "TARIJA",
GetAvaliableRates
This method returns the price list for the countries available for ARGENPER.
REQUEST
Field Name DataType Required Information Example
UserToken String M a8f5a221-c239-466d-b543-
67c785e149e0
RESPONSE
EXAMPLE SOAP:
The response received by the request done will come in a InvoiceSendResponse object which will provide the necessary elements t
if the transaction has completed or not.
EXAMPLE SOAP:
Response:
{
"ReturnResult": 0,
"ReturnCode": 13, "ReturnDescription": "OK"
}
GetInvoiceDetails
This method returns the rates for the countries available for ARGENPER.
INPUT REQUEST
Field Name DataType Requir Information Example Description
ed
UserToken String R a8f5a221-c239-466d- Token got from the
b543-67c785e149e0 Step0UserAuthenticate
AgentInvoiceRefer Integer C 1 Reference code between companies.
ence
InvoicePassWor String O ESP00001 Payment Invoice Password. Used to
d controls the transactions
Object: InvoiceDetailResponse
RESPONSE
SenderFloorAndDoo r String 10
SenderCity String 30 R
SenderPostalCode String 10
SenderProvince String 30 R
SenderCountry String 3R ISO-3166
SenderTelephone1 String 15
Tag DataTyp Siz Requ Rules Notes
e e ered
SenderTelephone2 String 15
SenderBirthDate Date 8
SenderOccupation String 50
SenderSalary Integer 1
SenderNationality String 3 ISO-3166
ReceiverName String 50 R Full receiver name
ReceiverSurname String 50 R Full receiver last name
ReceiverDocument String 15
ReceiverAdressLine 1 String 50
ReceiverAdressLine 2 String 50
CorrespondentNam e String 50 R
EXAMPLE JSON:
Headers
UserFunction:GetInvoiceDetails
Request:
{"UserToken":"e0a0ac1b-2595-423f-bb40- 142a13c03991","AgentInvoiceReference":12,"InvoicePassWord":""}
Response:
{
"ReturnResult": 0,
"ReturnCode": 2188020, "ReturnMessage": "", "SenderName": "KAREN",
"SenderSurname": "LUNA SOLAR", "SenderDocumentType": 10,
"SenderDocumentNumber": "15995123", "SenderDocumentExpiration": "0001-01-01T00:00:00", "SenderDocumnetIssued": "",
"SenderDocumentIssuedDate": "0001-01-01T00:00:00", "SenderStreet": "310 PRATER WAY", "SenderHouseNumber": "",
"SenderFloorAndDoor": "", "SenderCity": "SPARKS", "SenderPostalCode": "89431", "SenderProvince": "NEVADA", "SenderCountry"
"BOL", "SenderTelephone1": "7754402564", "SenderTelephone2": "",
"SenderBirthDate": "1994-12-15T00:00:00", "SenderOccupation": "",
"SenderSalary": 0,
"SenderNationality": "840", "ReceiverName": "KAREN", "ReceiverSurname": "CANDELARIA", "ReceiverDocument": "",
"ReceiverAdressLine1": "BOLIVIA", "ReceiverAdressLine2": "3771399", "ReceiverCity": "SUCRE", "ReceiverCountry": "BOL",
"ReceiverTelephone1": "59171552170", "ReceiverTelephone2": "", "BankName": "",
"BankBranch": "", "BankAccountType": 0, "BankAccountNumber": "", "AgentCode": 2620,
"InvoiceID": 2188020,
"InvoiceDate": "2019-12-15T00:00:00",
"InvoiceAgentReference": 12, "InvoicePassWord": "33TF031388402", "InvoiceAmmountToPay": 5.4, "InvoiceCurrency": "BOB",
"InvoicePointOfPayment": 0,
"InvoiceModeOfPayment": 2,
"InvoiceMessage": "UN ABRAZO A TODOS Y PARA TODAS",
"InvoiceStatus": 2,
"InvoicePayDate": "0001-01-01T00:00:00",
"InvoicePayDocument": "", "CorrespondentName": "EUROENVIOS S.A.", "InvoiceEvents": [
{
"EventInternalID": 4681645, "EventDate": "2019-12-15T13:37:00",
"EventType": "ORC",
"EventDescription": "999 GIRO RECIBIDO CORRECTAMENTE"
}
]
}
NTS EP S.A.
1
ed to transfer money
spondents, as well as the ability to do it
GENPER's System
ons to I-TRANSFER
Basic .Net which can be converts to
Revision By
CES
CES
CES
CES
CES
CES
CES
CES
CES
mx
mx?WSDL
1
ages. The methods are:
ULESNOTES
Allways 3
Allways 0
ARGENPER
IT84208
PC001
ULESNOTES
a8f5a221-c239- 466d-
b543-
67c785e149e0
= "PC001"
:"PC001"}
b543- 67c785e149e0"}
Description
ata to show")
AME As String =
ORRESPONDENT_NAME As String =
R.
Description
sult
ta
ror description.
ta to show")
NTRY As String =
CY As String =
PONDENT_NAME As String =
CurrencyName": "GS", "Correspondent": 0,
or ARGENPER.
Description
sult
ta
ror description.
ata to show")
g = RES.DT.Rows(i).Item("Ciudad") Dim
S.DT.Rows(i).Item("MasDatos") Dim
ULE_SAT As String =
BANCO ECONOMICO - AG. PRESTO",
Description
Token got
from the
Step0UserAu
thenticate
sult
ta
ror description.
ata to show")
YCODE As String =
String = RES.DT.Rows(i).Item("FixedValue")
ENT_CODE As String = 0
ES.DT.Rows(i).Item("CorrespondentCode")
RES.DT.Rows(i).Item("CorrespondentName")
mentName": "Ventanilla", "PercentValue":
ER GLOBAL PAYMENTS EP S.A. associated
.
to load a transaction.
EXAMPLE
1-c239-466d-b543-
149e0
JHON
DOE
US25574965
USA
EXAMPLE
1C
NEW YORK
NEW YORK
USA
14126654423
1979-12-02
USA
MARY
DOE
MADRID
ESP
34672665421
EXAMPLE
P5126451314526
100.00
EUR
145562
saction code. If
Error code.
description for that code.
cumentNumber = "123456789XX"
clamation)
t from the
rAuthenticate
de between companies.
Payment = BankDeposit
Payment = BankDeposit
Payment = BankDeposit
P method
28T12:06:00
orizado
= 13
to show")
ePassWord":""}
0", "SenderDocumnetIssued": "",
", "SenderHouseNumber": "",
Province": "NEVADA", "SenderCountry":
"ReceiverDocument": "",
RE", "ReceiverCountry": "BOL",
giro
9
s
pais para agente
iente
iario
s
etc.)
Retenido)
TIGACION]
ario
dor
ados)
neda de pago
ago
processed.
e validated.
send.
transmission.
smission.
dy to be paid.
s some type of note. Ready
t.
pliance Department
on request.