Saman MP Specifications
Transcript of Saman MP Specifications
����������� ��������
Saman MP Specification�����
������� �
Saman Micro Payment
Technical Specification
Last update at: 22 August, 2006 �22 Mordad ,1385
����������� ��������
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�'#�'���(����%�(��&��������&��#�'���(����%��&��������&��
����������� ��������
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*
����������� ��������
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*
����������� ��������
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
����������� ��������
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��*
����������� ��������
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���
����������� ��������
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�
��*
����������� ��������
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��)�*
����������� ��������
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
����������� ��������
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�*
����������� ��������
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�.
����������� ��������
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�����>�%$'�%�%�'����*
����������� ��������
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
����������� ��������
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
����������� ��������
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�� ��*
����������� ��������
Saman MP Specification�����Q
����$�*�,��9�3�#�'���(�PMerchant IDU�,&�G���)��002XXX-XXXX�%�����*�5M������I��(��&����������2 �6 �%
�`�)4���� C*