Saman MP Specifications

17

Transcript of Saman MP Specifications

Page 1: Saman MP Specifications

����������� ��������

Saman MP Specification�����

������� �

Saman Micro Payment

Technical Specification

Last update at: 22 August, 2006 �22 Mordad ,1385

Page 2: Saman MP Specifications

����������� ��������

Saman MP Specification�����

����������������������������������������������������� ��������! ����"���������#��$� ��� ������%�� � "���� &���&���&������� ��#�' ���(��) %�&�)��*����&���+�,&�-�������������.%����*

��������������� !�"�#��/0��&���������1������0��#�'���(����1�����/0���������2�����1����%

��������$%& � $%����'(�)�*�'� �'������'�� �%� �'�����������%

+����&#��") ��$�*�,�-#�'3��4���"��5

5'3��4��67�������6�%��2 �6�

���� �.�� /�.�$(�� ��0��#��0��%�

����#��$��Web service���

1����%�2�����4�8��4 ��

�67���8��4���9��:��

3��-�#�*���$�*�,�-�#�4�%�'.05�� ���%��6(�)��(5�'#�'���(����%�(��&��������&��#�'���(����%��&��������&��

Page 3: Saman MP Specifications

����������� ��������

Saman MP Specification����+

�������������� !�"�#� ���������������;�! �%�4��3����#��$������ �����<=�>���������<�/0��64� �.������(�?

�����7��7�����?��0���%�@�>4��3������������A��&�����3��*�8�9�:���B �����������'������#�C���(�&����������������4�&������D�*

��$�*�,���$�*�,�?��0���%����3���A�����&���&���3�� ���&���&����&��%���*����$�*�,��9(Merchant ID)?�E 3�4�Terminal ID���Acceptor ID�#�'���(���������D�4��3�

%�F�G�������*

(�)��(5�'�;$9���(Transaction)?�G�����������&���3�<%���,� B)H����%����������I�J�����*�#���-�(�)��(5�'?���%������������������KBL��%��������I�&���3��������&��,�GM6��������&��I�/ &���,&�3�

���&��%�)�����NB2�=�>���������4��&�#�'���(�#��O����� ���%�)�� �����>(��,&� -�&��� �I� ����� ��/��<=�>�����&�� �����" ���%����������&��-�=�>�����I����*�P�� �&� 3�����8����&�%����6 M����� 'H�� ��� ���4�%����

������(�7��Q��&��#����R��� ���S��T�U��'.��<�0���#�(Reference Number)�?��B!B����� ��3�&�3��!��� 3�����2 ����� ����� ��%��� ��

&����'H ���"������A������5'3��4#�'���(����&����������V�&��%���*��*�&�����(Reservation Number)�?�3�����#�'���(��3�����5'3��4�������Q��&��&��%7� �����

�����&��%�������<�3��I�D�4�����4�������&������ C ����'3�*P����������#�' ���(��) �&��5'3��4��GM6�8����&���U*

Page 4: Saman MP Specifications

����������� ��������

Saman MP Specification�����

������$%& � $%����'(�)�*�'����' ���7�S��L4����W� �X���Y��'�� ��Z�@����������������.2�� '%P�SSL certificate�U%������*

�� '����' ���7%����R7�3�[�&�Z������&��P�Encryption�U���&������\�I���)4�%�����YB��(���,�H\]��%��%���� ��������������=������&���&�3�������^��� ����3%�����*���&�/7�3�Z����������������������'���&��� '��_9����4��������=� >����

������#���%������*�����Z�������&��[�&������������&����#�������3������̂ ������������������� Q���&� ���� �^�������� -���C'���.�4���httpsP�Secure http�U�'L�����0�������^���http� �#��$���%��� ���*�����`&�I�� ��=� a�&� ]�� �

http://www.sb24.com���������)L���#���3�� b�,&�-����,�H\]��%�����=������&�%�����X�&������%����`&�I�����3�https://www.sb24.com��������������=������&���&�3�������^��� ���#���3�,&�-����,�H\]��%�����*����3R������

��Y����^���3���%��&����&�� B��������%�3��'����� '����' ���7�%������' ���7�����&��-�/3�������&������ Y4�&���#��3���'����#��3�EG����������^��*

���$%& � $%����'��Y������������Pwww.sb24.com�����acquirer.sb24.com�U��&����� ����' ���7��� � '��%��� 2�L�

%�'��������������&������1�24&��,���!��&������4�%���������#�'���(�SSL������"����*�&���/ ��#�'���(��7���2�L���' ���7����!��&��/ ��#�'���(���&������� ��1�24&��<�����SSL ������� ��� ��������,&�-����*��� �'��

�&���#�'���(�&�20��<������2�L���' ���7����������C'��������Y����B��<�! ��*�� '����'�� �%�������������,�H\]��������3�c �����#�'���(��3��!'����C���%���&�������P���'��,�GM6��<,&�3�

������0����/ �<,&�3�/&��)B3�������U�****���6��8B9�*���� )���������,�H\]��Z���c ��&���������#�'���(��]��%�������%)���(��&��%�)4����'3�%��&������������&��&������D�4�,�H\]������%����*

�'�� ���� '��%��������5'3�� 4����� ��4�����&���3��'����&������"���7�'���(�D>(��3���������C����������'3�&��-��&�5'3��4������&����67�������&��'�*�������&�����������������B0�=�����(����������#��&�I��7�� ���

PAcquirerU�������`&�I������#���K>d�IP���������#�'���(�����������#��0���4�<����#�����������%���� �������&�� -��I����*

������������������)B3�<�'���&����67�������&����C'��&��#�'���(�����������' )]��/&������#����#�' ���(����%���3�������� ������#� 7&��� �����������5'3��4���������67�����C'��&P�Payment gatewayU�#����

����P�*��)B3����/&������#�&���C'��&�������#�'���(���#����#�'���(���������e�]����=���&���%����U

�$%&��'(�)� ���#��O������#�'���(������� �������%����/���&��������̂ �� ���f H��� �����:� ��(��������������� 'H�� ���&��I���� ��)�g��#��O

#�'���(�g���)��%(�L�������������*�������/ �����������#&�)����Merchant ID������F�G���������'���(�5'3��4����&���3�����V�&������&�����#�#&�)��%�%(�L���������'3*

Page 5: Saman MP Specifications

����������� ��������

Saman MP Specification����=

+�&#��") ��$�*�,�-#�;$9����><��

����#�'���(������&�&����9>�������%���&��#��I��3����&�����Y����=����(�%���������� 3�� ��� ��%�� ����*���&�� ����� 9>������#�'���(�����)��=�2����&�����.X���?h*����$�*�,,������)���������7���1*��(�)��(5��-�#'�%�'�����#�,��:���������&����^��� �������2 ��

����%�#����(�P�RedirectU�%�����*;����&�������3��������-���,&����POST�#���%���������'4&�2H?

i*Total Amountii*Merchant IDiii*Reservation Numberiv*Redirect URL

Total Amount������NB2�%3�������#�'���(��%��&��&�� ���������������� ��)��� (�*Merchant ID��3����#�'���(��3�������� �'��%�#�' ���(�&������ ������5'3�� 4�� ���*

#�'���(������ ����Y��Reservation Number�� "���session���cookie��� ����E >L4����&�������67������(&�������������^����������'3�#��$�*���������2��`&�I�%�����=�&����&����

https://acquirer.sb24.com/CardServices/controller �%� ����*��� 3�&�9�� )���#���6%�.�4�����������^����������� '����' ���7������^�%�#��$���%�'3�*

�������&���.�3�:����&�20�����&� �������������������&� ����&��#�'���(��3�%�����) )@�&���&�R7�i���#���#�&�I�*

j*�������7����������%�0��*�?�@A%�>�,��0����4B��%��*�8�9�8@AC%'����$9��:��&������2������^�����%����&�����,&�3�,�H\]��&������<�'3��&�������������&������.?

i*�,&�3�#&�)�PPANUii*�&�2H��)B3PPINUiii*�f>���k�&�4��,&�3�PExpire DateUiv*CVV2

��0�4?�&�������&����������2������^�%���#�� ���-���&�3�c ��#�'���(���#���%���&���&�&�������*

l*���(�)��(5��-�#�1*'�������*�,�-�#�1*��)���������7��%���$'���#�,��:�������2 ����� �^�����%����������#�'���(��������#&������&�&������<5'3��4���)4�����A������`&�I����RedirectURL��%

�����(PRedirect��%��'3��U�����^�����#���`���������&���#�'���(������� ����2 �%��� ���&����POST%��(��&���'3�*�����&�����&��%����'4&�2H�?

i*Transaction Stateii*Reference Numberiii*Reservation Number

Page 6: Saman MP Specifications

����������� ��������

Saman MP Specification����D

�%�#�'���(������ >(��<5'3��4�� L@��`����������4���������m M64��&�5'3��4������/ I�*��:� ���) )@�&�������&���.�3i���#���#�&�I�*

n*�����%�E�AC�����;$9����-�� *���$�*�,'���0��������F%�GFH���F�B�*�'���F����:��&�������� B (������(�5'3��4�� L@���#�'%������������� ��������#����/ I�� >(�����������I��3������0�������4��P

�������� 7�; )G4�#�d�����B (�����K ���&��>���&�����) )@�&���I�i�� ��#���#�&�I��*U����7��I�������J7�-#���K�%���$�*�,�0�5����%B�-�L,�% ��������������FM�,��F)��F����F)������%B�0��*��)�

����)�;$9����-�� * ��������)�*���0�2��������7���FL�N0�*�����F��O)���NF�����FH'�*�� ���0�0�-#����5'3��4�� L@���7��OK�<�����#�'���(�%�� � "���� &P�Reference NumberU��&���&��#�C��"�!0�����#���%�'3�*�&�3������7� B0�&� Q'��� ������Double Spending��� ��

�������� "���� &��������e�G�&����%%������*#�YH����\�3��Bo!�����(���#�' ��� %��� ������&������������� "���� %���������(�����Gd'�,&�-����PUnique�U������������� ��% �&�� -������e�]���

����������� "���� &�����e�G�&������������&������%����� B)L���A �H�c ��%����� )����6 ���&�%��� ���*��&���I���0����H�,&�-4�H\]�������&��%#�'���(��<Verify Web Method��� ����&���� ���&�

����-���%���?i*Reference Numberii*Merchant ID

��#�'���(��)���������%�(��&���" ��������������-��&����������5'3��4�������� ��)'���$�3���*����6 7���&�� >%�&��>������������8��4����������.3PTotal Amount�U�����&���5'3�� 4�,&� -�� ���� b�&���������

��.�6%������*�����B2���NB2������!��>����&��3�(�N����������&���&� ����&������#�'���(��3�n������ ���� ��X���I���0����������)?

i*���������� �#�' ���(�<�' ����������NB2���������7�%������������ ��)��� ��&���&��� ��A��� �� ���4�*P�BX�pU

ii*���������NB2��7�%������� �#�'���(�<�����#�'���(�&��3�(�NB2������)3�%�������A ��� ���4���&��'�.3�<&����������\H���/���67��*

iii*���������NB2��7�%����������#�'���(�<�����#�'���(��/��&��3�(�NB2������6 ��%���A������4���/���67����&����'�,��$���������<&����������\H����*

iv*0���%����$'��7��8��4�����%�����C�� ��������������&��9�%��%����9������:����3���������#���#�&�I�^��) )@�&��/ �*

:��.3�8��4�����/ �����#�I�^��) )@�&��*

p*�����7���*��P�(��:�����������&��,&�-�&�5'3��4����#�' ���(�<�����%�� � "���� &���&� 3&�&���&��I����1���Reservation NumberP��3������� ����� �����&� ��� ����� 'H����5'3��4����.2�

������������������#����`� ��#�' ���(�������������^��5'3��4�����L����#���#����`���� U�������&���#����#� C��+���� ��#�%�'3�*��������2���&��,&�-�&���NB2��>���%�/ �����%��� "���� &�+ ��#�%���4����

���&������������������2��\ )H�� 'q���� ����V�&��#�'���(�����&��I��67�������&���������� ��������� ��X�� ����I���0��*

Page 7: Saman MP Specifications

����������� ��������

Saman MP Specification����Q

8(�:S���U�3�4�#&���� ���%���7���e�G��3����%���%��� "���� &���L4�#�'���(��)�&� ���C�����&�����%�����������

��������)�&��*������NB2���&�2�H���Y'4��������#�&�M���67�����%��� "���� &���[&�/7��&%����*�� ���4�4��� �E������%�����,�GM6�����4�%��� "���� &����������[&�/7�#�'���(����&������'q��&�I��L @��� 3 ��e�G7��%��r4��I� ��'3���*������!X�����&��[�&������#�'���(��7���3����������������%��� "���� &������&�

"'&�2�H�%����������������������� ��%B ���������^��0�����%����&���=�&��#�'���(�������&��" ����/ ��������������������������<����#�'���(������%��� "���� &��������������#&� ����� ���4�% �#�' ���(�������� ���M��� ������&�����&�2�H�

��H����@�>4"'&�2%��)����������������������������#�� 3�#� �+��� ��#����#� C����&���&��I�� " ������ ��� 2a�,&�-�&������� L@���&�5'3��4�� &����� r4�#���e�G���*

^�U�4&�-�&�%�����8��4�^��0��3�verifyTransaction���B ���������%��������#�'���(�������PTimeout���<�� ����������������#�I�5 ����2��.�6�U�***������#�'���(�������GM6����L4%��L����"�%����)���*����&�� �4��������

�4&�-�&�%����������������� " ���� �'���� ��<� ���#�' ���(�������^��0��3�������"��������verifyTransaction

�����������9��#�'�����6��P$'%�������*U���GM6����L4�����L�%�������������^�� 0��� '��� 7��#�' ���(�E ��0����[\4�L������#�'���(�<�6���(��&�%5'3��4��'3���/���67���.�3�&�]�����&�*

,�U�4&�-�&�%�����B ���������5'3��4��3�%����GM6�����,��&��%�P������.���X��@�X�=�X�&�h������a3��X����H��j�H�U��3�������5'3��4������67�����������������<�6��� ��4�#�'���(�E��0����*

s�U���&���t[�&������������<������������'�������%��� "���� &��#�'���(����&���������#��$� ��S B�M������ 0��<�� ��&����<�3��q������&�����!�������B0����#&�)�������0�4���IP�#&�)����#��O����%���(�7�#�'���(�.

W�U��! 7�B0�� ������Double Spending�#�YH����#�'���(�$L @�,&�-�&�������%��&��� #����� ������������0����I�&�@�<#�'���(��*

:�U'� ��������5M��� ��)3����;�!SSL��ACL�4� ���#����*u�U�����&�������!������S>����#��$������5M�����������������������0���������&����������� ��[��(�����C�����

#�'���(���,&�-�%7 ���*�����L4����&�� ���#��O�=�>����S>������������%������4 �&���/��#��O��!��������&���������)�����*�����#�'���(�� 'v)���������������� ��[��(�N��2��a3��X�<������������[��(���C���%(�L��

%�%(�L��&���)�*

;$9����-CI�)��#�'���(%�������r�����������4����&�� #������'3��*������&� �,&�-������������)�������� ��8 ������

���?•��r��#�'���(������������������&��P������#�'���(������)�=�a�����3��C��������&��A

����Q�������&�&����d4��������������.*U•�����&�������r�����.��������*

����&���#�'���(�<�������X��������%�����4�������,&�-��������&�������67��?h*�P%9�-CI�)(Full Reverse):������#��O �#�&� ���6 7���.�3�,&�-�����'�� ���� ��&��

����NB2�����&�����!��%����������NB2����#�'���(�#��O���������&�������*���������� ������#�' ���(�&� 3�����������#��$��������#�C�<����#����%��� "���� &�����1���Reservation Number����&� �

�����)��W��M����&������Q����AO��������L@�����3��q���� ��67����7�&��%������� 3������o)9��I���V/0��67���\2�%����������#�&�M��.�3�P������(�-�������q�������2�������2��,�]�24&��&��%��0���

Page 8: Saman MP Specifications

����������� ��������

Saman MP Specification����R

�����% �,&� -�/ ��� �����) �&���q��������7������� 7U�*���AO Reverse Web

Method�����&�������&��+����(�.������������?

i*Merchant IDii*Merchant Passwordiii*Reference Numberiv*Reverse Amount = Total Amount of Invoice

������% ���6 ���&��6 7����" ����3������3��������%�67���&��>�� ���*���AO �#�' ���(���#�C���&�����&�����#���%�)���*0����:���%���#���#�&�I�^��) )@�&���������*

j*�-CI�)�EN�(Partial Reverse)�?6M��#�'���(%���NB2�������67����&��%����*�������3���`������#�'���(�&Business Rule����67���NB2�����%� ��2�d��&�%���� ����� '3

������#��$���#�C�<����#����%��� "���� &����1���Reservation Number������Q���&�����W��M����&%�)����*�����#�'���(�AO��L@��� ���7�&� ���67����%�����%�� � "���� &���� q��&

����4&�-�&���Y'4����'3%����I�������&���V/0��67���%���)��#��$���� ������ 3��� ������ ���� V/0��6 7�����6%������#�&�M����������67���NB2��%�����67���N��2��(�@���������� V/0�%���� 6 ���������' �N B2�. 3�����

� ����2����6P����������3��q�������2�� ���(�-������/�����2��,�]�24&��&��%��0������ ����3��q������%�,&�-�/ ��������)�&���q�� 7U�*&����� �#�'���(�,&�-��%�� ���4��� )�� Reverse

Web Method�����&�������&��+���������(�.?i*Merchant IDii*Merchant Passwordiii*Reference Numberiv*Reverse Amount = Desired Reverse Amount

������������%�67���&��>������������% ���6 ���&��6 7���� " ���� 3������3�� ���*������ ��X�� ���&�#� C����� ����#�' ���(�� L @����� ��)����&�� ���&��� ��#����%�� � "���� &��I�� ��1� ��

Reservation Number��6 7����4����)��#�&����67����&������� L��% V/0��� ��� ��&������)���*

8(�:S���U��%�� 3�4�#&��������3�����/�%��&����L@� ����7�&����67��%���%��� "���� &� ������ ���&��&��-����5

��������3��q�w�����q�#�'���(�D�4�<�I�����0�����.2���������������� &�#�&� M���6 7���NB2�<#�'���(�&���� ����" ���%��2�d��&�%�$3�,&�-�&�����'3��������0���&��67���&����<NB2��%�)����*

^��U��������/����67���&����������������������������������&��-�#�'���(�����������3����7��o)9��3��I���������&�� ��������#&�)��<���#���&��-�#�'���(�IP����&� 2H�� )B3���#�'���(���� �� q��&�%�� '3�*���&� ���� 7��� " ������7����#�'���(������������3�������&��%���(�����4�����������<� '3���bI������&��67����'� ������&� 2H�� )B3��

�&������&�� �#��������<�����hard code�)����*i��U���� )3�� ��;�! ����5M������� '�SSL�<ACL���Merchant IP and Password���#� ��� � 4�

��*

Page 9: Saman MP Specifications

����������� ��������

Saman MP Specification����S

,��U������������%�,&�-�#�'���(������[��(�����C������#��$������5M�������!�&�������� 7�*����% (�L����#�'���(�������[��(�N��2��a3��X�<������������[��(���C������%�%(�L��&��������)��*����&� �������&�����������"���

�67��%�����W&����3���&�����C����%7 4�4�<��� ��������M���x��E*

Online Demo:�#���6������������online demo�`&�I����<�������#������&�'����ir.sep.demo://httpL0���� '3*

Sep IMS?�#���6 ���� ������online ����&�� ��&��� �(�7�,&� -���Y6 '3��4��! ��� ��� ���4�% �`&�I�

https://acquirer.sb24.com/MerchantService/jsp/loginPage.jsp�� V�)���L0���*�P���� ����&����� �'(�5M�����������I��(��&���Y0��3����&�2H��)B3������������ ��;�! ������� C��`�)4�%U*

�C6��5'��C%��4��I��������3��0�������,�����V�&��=�X&���)���jnyzP����&����2��U����<� ������� �^� "��������� '�%������ 3�� '3���2 �6�%��������/ (�`�)4��9>�����K��]����%jnyz���������7�� 2L4��)������&��/ ��*������� �� 3�`� )4��9>������%

����$B4�.�������4Email�����������#�'���(�����^��&��&���I���_@���,&�G��������#����5��)�*

Page 10: Saman MP Specifications

����������� ��������

Saman MP Specification�����T

����

��.��:/�.�$(� � �0��#��0��%���{���'�4����;�! ���������#�� ������Web Services���� ��� 9>������9>��%]�24&�������#���#��$���

���������&�������������#�'���(�%���7�*���A����=������&�������%����&�������E��0�����3�%���&��%L��� 4�E����&�������&� ���#�'���(��%�&��������&���4��� 7�������)��#��$������I������*%�#�'���(������4��; >!�,&�-�����&�8���4��

����������������������-������*����� ��������&��,�H\]��=�>�������.�4����K��9��4SOAP1�������������*���.�4�������SOAP���������� '�����������

�#��������������&������������XML��%�#��$����'3�*�����#����=�>���/ ��,&�O!���4�����&������.�4����#�YH������HTTP�������HTTPS�%����*

����#��$����!XWeb Services��&������{� ��'�4�� ���������4�%�#�'���(��3������������� ��� #����� ��)��#��$�������������*=�a��%��#�d�����consume����� ������(������3�� ���web method���� ��� ������ )H�

{���'�4����Y4���0�� ������#����#�'���(�%�������I��������4����7�#�Y������� ��*

�&���0��#�Web Method��:��������������#��$�������Web Method�'�4��d4�����{��PHP������������<PHP Module���������&��

NuSOAP���'���(�;�! ������������������� ��� 3�&���&��I�� !���� ��)���(�@��#�P��������#� ��#����� 3�� ��)��K�� 9�U� ��)��mM6*

�����{���'�4��d4ASP�������������SOAPSDK����������� ��)��EG ��#�' ���(�;�! ���&�����&��*���� ��SDK���&�%������� ���4http://www.microsoft.com/downloads��� ��)���(��&���*���������)��&���I����#��$���[�&

���#�I����3*���{���'�4�&�ASP .NET�%��2 �6��������4�%�����.NET��� ����������� -�Web Method��#��$� ��

��3�*���#���#�&�I��3����)��&��#��$���[�&*��{���'�4�&���$���%���/ ��%�����2 �6��������4�%�������������������!����%�������� 3�#��$� ���P������� ���M! ��&��� �2���

-��%$������%��2 �6������%��&����� 0���*U��� $����M! ��� 7�%���) ��Web Service��� Bd�,&� -�� ���&�%��2 �6�%�)��%��<�'3%�����&�/(��������!��������4��SOAPSDK��� ��)��#��$����*SOAPSDK�����,&� -�� ��

����ActiveX���&�� �����Y������a3��&���3���|������������!�%��%��3�#��$����I�������4��*$����3����)�%����������0�����X������*

��{���'�4�&��Perl�����&�/(��������!�����#��$����SOAP-Lite��� �� -�4�%��� ��*)���������^�������� -�� 3�� �������0������*

������{���'�4����������0����<�����wrapper���&�����interface�����������������#�����"��client.jar��� 3������&��I��P��#��)�������Cjar��������#��$������D24��Web Services�U�&�classpath���&�������� �*

1Simple Object Access Protocol

Page 11: Saman MP Specifications

����������� ��������

Saman MP Specification������

1�:�2��Web Methods

���8��4�(Web Method)����&�� �&������7�'���(�&�%7 �������&���:����3����&���� 0������%��� ��� ��&���+������#�I�.*�����������0�4���� ��������3��type��>����&�����67�����%����<����H�%�%������ ���� ��&��� 3��'���

��������!%�,��$4������)���'���*'v)� �67���&��>��%���#���mM6�8��4��I������������8��4�*

�U�V)�;$9����G������double verifyTransaction (

String RefNum, String MerchantID,

)

�����&������&���8��4�8�� �� W�� ��%��6

%��� "���� &�#&�)���� �!�������D�4��I�� ��4����.����3�� *��3���������j}�������3�&�3�*

String RefNum

#�'���(��3�*%��V�&���&������3�#�'���(����&�3����,&�-�����3��������'3#��O� #&�)��%� ���C�� ������7� *���� #��O� #&�)�� ���� K��94� AO#��O�#&�)��&�����!�� <#���#���� t%��� "���� &����1�����'�&���3���

%� �q� <��� #���%��� "��� � &� �3� ���7� �o)9� #�'���(� �4� ���7%�������1�������*

String MerchantID

S���=��0~h�����&���:����verifyTransaction

4�%�67���&��>8���?%���6���&�%��>����NB2�<������2a��3�%4&�-�&��&��>�����<�����%$'��3�%4&�-�&���������9���3�e�L�*S���=��0�&���9������3�:���~l���#�I�*

Page 12: Saman MP Specifications

����������� ��������

Saman MP Specification������

j�~�V)�;$9����40&�-CI�)int reverseTransaction (

String RefNum, String MerchantID, String Password,Double RevAmount

)

�����&�����&���8��4�8�� �� W�� ��%��6

%��� "���� &�#&�)�� �!�������D�4��I�� ��4����.����3��*�������3����j}�������3�&�3�*

String RefNum

#�'���(��3�*%��V�&���&������3�#�'���(�#&�)�����&�3����,&�-�����4��'3���7����C�����#��O�*���#��O�#&�)������&�#��O�#&�)������K��94�����

��q� <���#���&�����!�� <#���#���� t%��� "���� &����1�����'�&���3%���7*

String MerchantID

��)B3/&#�'���(� String Password

��3�%rB2�#�'���(�.����������67���%��� "���� &����1�����'�����*��0�����5 ������%��q��67���&������NB2��������NB2������3��'3

�������)3�� 6 ��%V/0��67���N��2�Z�)"����� ��x���=�>�����'*

Double RevAmount

S���=��0~j�����&���:����reverseTransaction

��8��4�%�67���&��>�?�������%��'���(����67���,� B)H�� L@��e�L�&��>���������*��&��>�%�67�h��� >(��e�L��% �� 9��� 3�% $'����� >���� ���6 7���&��' ����*S ���=�� 0�&��� 9������ 3�:� �~l� ��#� I�.

Page 13: Saman MP Specifications

����������� ��������

Saman MP Specification�����+

��9�2�� J7�

8�� �� *�9%�����2��%B������9�* -1�

#��O�'�! ����������*�P)����0�����D����������@�X�=�X�&�%��I�U -2

���&����"� b������3&�3����X���%�'���* -3

Merchant Authentication Failed�P����#�2����#�'���(��3����&�2H��)B3U -4

Database Exception -5

�����(���.�3��67���\2���'* -6

���%Y4�%��� "���� &* -7

���&��=�]�����"��X������6 ����* -8

%�67���NB2�&����"� b������3&�3���0�* -9

&�,&�-����%��� "���� Base64��! ��P�����"� b������3&�3����X*U -10

���&��=�]�����"��X������)3���* -11

���%$'�%�67���NB2* -12

#�&�M���67���NB2����5 ��%V/0��67��������%�67���NB2���%��� "���� &��* -13

���#�6��S��L4�%6'3��4�� 'q* -14

�67���NB2%&�6H��,&�-��������#���#����* -15

�9��B����%;�! � -16

6'3��4�%�/0������67��%�����,&�3�����3�%�����(��R����"���������������� b�* -17

IP Address ����2�L����#�'���(�* -18

S���=��0~l�:������3��9��

*C)�����3�����>�%$'�%�%�'����*

Page 14: Saman MP Specifications

����������� ��������

Saman MP Specification������

3�: ���%��6��-�#�*���$�*�,�-�#�4�%�'.05(�)��(5�'

��������������#�'���(������3�%������&����������2�%����,&�-����POST��%��V�&�����������,� H\]��� ��1� 24&��&�����'3%�5'3��4�'���?

8�� �� ��%��6=��&���������NB2 Amount

Reservation Number ResNum

#�'���(��3 MID

�`&�IURL�&��3������5'3��4��" ����������(�7�&����#�'���(�� ����,&�-�����d$-����POST�=�&��%����*

RedirectURL

��������������#�'���(������3�%������&����������2�%����,&�-����POST��%��V�&�������� 4�� '3���� T�������2 ���d$ -�����%�&������7���������K��9�?

8�� �� ��%��6���&=��0����� TableBorderColor

A����&�/3��=��0��' � TableBGColor

%B-���d$-��' ��A����& PageBGColor

%B-���d$-������& PageBorderColor

�d$-�%B-�����'H����( TitleFont

�d$-�%B-�����'H���& TitleColor

�d$-�%B-�����'H����(�#����� TitleSize

������(�%���%���6���&������&�������>����,�d @�4��3�'��* TextFont

�����&%���6���&������&�������>����,�d @�4��3�%����'��* TextColor

������(�#�����%���6���&������&�������>����,�d @�4��3�%����'��* TextSize

������(������&������'H��3�%���P��'��g�(����#�'���Ug%���6���&�'��* TypeTextColor

�����&������&������'H��3�%���P��'��g#�'���(�����Ug%���6���&�'��* TypeTextColor

��������(�#�������������� ����&������ 'H�� 3�%���P���� '��g���#�' ���(��� ��Ug�����6 ���&%�'��*

TypeTextSize

#�'���(���7���.��(�%����'���`&�I LogoURI

Page 15: Saman MP Specifications

����������� ��������

Saman MP Specification�����=

������3�%������&���������2�%�,&�-����#�'���(��������POST%��������7?

8�� �� ��%��6Reservation Number ResNum

��� "���� &% RefNum

5'3��4�� L@� State

(�8:����h�?�����������3�%4&�-�&�RefNum������������6 �� 3����������'L����<�����7���#�'���(����%Y4����&��%B��5'3�� 4

���#�I���0���&������D�4*����j�?������<�����#�����"���� >(�����5'3��4��3�%4&�-�&�State����������OK��� ���������*����,&� -�� ���� b�&�

�����%�#�����7���#�I���0�����9��:������*�����%��B (������)3�����)��������&�5'3��4������K(����. ���� ���4� �����6��&��������*

����l�?��7��%�X�#�'���(Session Management#�� ��`�������&������������Cookie Based���"������<�����#�������ResNum�������������&��`����3��q����������=� )L�� X����5 ��� ��������&��&�������7�

�<���&RC�����Session��67���&��#�'���(Expire���#����7�*������n�?�����2!��;�! ��������������������� ���&��� 3�%2 4�4�� )������&���� r�������R�������`�!X��q�3����&/��e��X��

��&���=�&�����#����3+�#�/0*

����B (�����>State�������������9��Z���ST��#�'���(�<���#���#�&�I�����=��0�&��k���&�����������0�4�����&�#�I���0�������������=��0�����'3�mM6�&������?

>�X�% ���L%�4���D�4�5'3�������#���.!'3�&* Canceled By User

���67����'�NB2%����B-��5'3��4�NB2����<%����6 ����*

Invalid Amount

�������&��<���#� &�5'3��4�����67�������&���X%B-��5'3��4��3�%)���� ��%����*

Invalid Transaction

���#�2����,&�3�#&�)�* Invalid Card Number

-�� 'q4&�3�#�''3�&��%�&������0��* No Such Issuer

�����k�&�4���>�f����������R7�,&�3�������C���,&�3��! ���2�L*

Expired Card Pick Up

�,&�3�/&PPINUl����#����&���#�2�����24�����������=�L(�� b�,&�3��" ���&�*

Allowable PIN Tries Exceeded Pick Up

�����,&� 3�/&�&�����PPINU�������#�� 3��&���#�2� ����&���*

Incorrect PIN

Page 16: Saman MP Specifications

����������� ��������

Saman MP Specification�����D

��������S>����5 ��NB2%�����* Exceeds Withdrawal Amount Limit

��5'3��4Authorize����#����P��#&�) �PIN

� PAN�'�!���&���U��%���&����'�������&������0�*

Transaction Cannot Be Completed

���� ����2 ��&��5'3�� 4%Timeout ���#�&���*

Response Received Too Late

�����B (����&�����CVV2������B (������ExpDate���&����#���#�2����P�*���#������&���\-����U

Suspected Fraud Pick Up

��0������������(�3�%�&������0��^�!X�&��* No Sufficient Funds

������������� L @��&��#� ''3�&�� -�� ����,&� 3�;�! 4� B)H%! ���*

Issuer Down Slm

����9��� B3������� ���C���%�������� 'q��� "���� H�����9�%�%���7�*

TME Error

��(������������'���&��,&�3����#��$���8���&�j;�&����� ��/&�#&�)���*��%�,&�3�/&����&��������PPINU�C�������3�

���"�/&�P�CVV2�U%������*PIN����)4�&��,&�3�%��;H���Y6'3��4���������#��$������ATM�����POS�����&������'�������#��$��%��������#�2������&��,&�-�&���������l�����6 ����&����������,&�3�����=�L(�� b��H���%����������7�CVV2���!�/&�

�����#���i�q�,&�3��6��&���3���&������l�����;�&�����&��hz����4�h������,&� 3�#&�) �� %��� ����������������#��$� ��� Y0�D >(������'�����%�����&�������������������)��,&�3�����=�L(� b��H����������;�! �����I�#�2����%����7�*�������� ��� ���3+�.�����

�����L4PIN��,&�3����������ATM����]���������L0�����������������L4�CVV2���������,&� 3�#�''3&�� -��2L ���������������L0��*

��� ��)�G�)�-�#�Y�0B;$9����><'.��<�0���#���*���*�������,�H\]��=�&����������2�%%�,&�-�.�+�`&�I�K��]������ 7?

https://acquirer.sb24.com/CardServices/controller

�Y�0BWeb Service Provider

���������(�����Web Method`&�I����%�������������� '3�#��$���.�+�����*��� 3����)�����<��6 ��,� V/0���������#��$����&���{���'�4����1���� '3�Z�0&�?

https://acquirer.sb24.com/ref-payment/ws/ReferencePayment?WSDLhttps://acquirer.sb24.com/ref-payment/ws/ReferencePayment

��;$9�������C% *���)�����><��� #��G�)�-���5'3��4�#���6�`&�I�#�����"���?

https://acquirer.sb24.com/MerchantService/jsp/loginPage.jsp

��������%����������)!������(��V�&���&�����&�2H��)B3���#�'���(��3�� ��*

Page 17: Saman MP Specifications

����������� ��������

Saman MP Specification�����Q

����$�*�,��9�3�#�'���(�PMerchant IDU�,&�G���)��002XXX-XXXX�%�����*�5M������I��(��&����������2 �6 �%

�`�)4���� C*