WyWallet WyWallet sms payment api version


Definitions and abbreviations



Download 405.9 Kb.
Page2/6
Date05.01.2017
Size405.9 Kb.
#7131
1   2   3   4   5   6

1.3Definitions and abbreviations





Terms, acronyms, abbreviations

Definition/Description

IP

Internet Protocol

MAC

Message Authentication Control

MSISDN

Mobile Subscriber ISDN Number (Mobile phone number)

Portal

In this context, the website where end users can manage their WyWallet Account

SHA1

A cryptographic hash function designed by the National Security Agency (NSA)

SOAP

Simple Object Access Protocol

UTF8

A multi byte character encoding for Unicode

VAT

Value Added Tax (Moms)

WSDL

Web Services Description Language

MAP

Mobile payment Access Point

PSP

Payment Service Provider.

SSL

Secure Socket Layer


2API - Overview




2.1WSDL URL


Test URL MAP SmsPaymentService: https://mpaymenttest.payex.com/MAP/SmsPaymentService?wsdl


Simulator URL MAP SmsPaymentService:

https://mpaymenttest.payex.com/MAP/PaymentServiceTest?wsdl


Production URL MAP SmsPaymentService:

https://mps.payex.com/MAP/SmsPaymentService?wsdl


See also section 6.1

2.2Method overview


General

  • Header

  • Status

  • Footer

SmsPaymentService



  • Purchase

  • Reversal

  • CheckOrder

  • Credit

  • Ping

2.3Synchronous Payment overview




2.4Asynchronous Payment overview



3API – details

3.1General

3.1.1Header


Name

Data type

Description

Mandatory /

Optional

AcquirerID

String

This ID is provided by WyWallet and identifies the application using the API.

The AcquirerID and MAC key in the footer are linked.



Mandatory

AgreementID

String

This ID is provided by WyWallet and describes the link between merchant / acquirer / product / merchant account number etc.

Mandatory

TransmissionTime

String

Format: yyyy-MM-dd HH:mm:ss

e.g. 2010-12-04 14:45:53


Must be UTC

Mandatory

ClientIP

String

IP address of end-customer/client.

This can be used as an additional option for fraud detection and other security issues.



Optional

PostbackURL

String

See chapter 3.4 for further details

Mandatory but only for asynchronous accounts

PostbackTimeout

int

Desired max number of seconds between initial request and the postback. Should be set to at least a few minutes for operations that require user confirmation / pin code etc.
If set to 0, the MAP system default timeout is used (e.g. 15 minutes).

Optional




3.1.2Status





Name

Data type

Description

Mandatory /

Optional

TransactionsStatus

Int

0 is general OK
See specific list for each operation for other statuses.
This parameter reports the technical status of the request.

Mandatory

TransactionStatusDesc

String (200)

Short description of status

Mandatory

OperationStatus

String (30)

This parameter states the logical status of the request, may also be a 3rd party error code.

Optional

OperationStatusDesc

String (200)

Short Description of OperationStatus.

Optional


3.1.3Footer


Name

Data type

Description

Mandatory /

Optional


MAC

String (256)

Message Authentication Control.

This is a calculated field. WyWallet provides the key (shared secret) used when generating this field.



Mandatory





Download 405.9 Kb.

Share with your friends:
1   2   3   4   5   6




The database is protected by copyright ©ininet.org 2024
send message

    Main page