Member Workplace Payment Page

Payment Service is a service that allows customers to pay by credit card in one step. You will be able to receive payment by credit card from your customers via payment form which you will prepare with this service. In this integration the Payment Form will be created by you.

In order to prevent the out-of-service situation of end-users, you need to integrate the transaction result service into your system.
Successful and unsuccessful result pages are created to give information to users.In the event of a system failure, it is necessary to use transaction result services in order to avoid situations where the end user does not have access to the successful or failed page.
You can access the most appropriate transaction service for you by clicking Here

Payment with 3D Secure

The payment method with 3D Secure is a process used to complete credit card payment transactions via the bank's "3DSEC" verification page.
The end user must be directed to complete the 3DSEC step to delivered URL via the response message.

Payment Integration with 3D Secure, input information for Restful Service should be prepared in XML format and sent the following address with Post method.
https://www.nomupay.com.tr/SGate/Gate
Note: The url parameter sent to this field should be open to the "post" request.


Service Input Parameters


  • Input Information
    Parameter Name Data Type Mandatory Description
    ServiceType String Yes

    Static value: "CCProxy"

    OperationType String Yes

    Static value: "Sale3DSEC"

    Token Token Class Yes

    Token Informations. The following internal table describes the internal parameters.

    CreditCardInfo CreditCardInfo Class Yes CreditCardInfo Informations. The following internal table describes the internal parameters.
    CardTokenization CardTokenization Class Yes CardTokenization Informations. The following internal table describes the internal parameters.
    During credit card transaction, if the transaction card is requested to be recorded on the NomuPay system, or if a transaction is performed with a previously recorded card is requested, values under this class will be sent in full.
    CustomerInfo CustomerInfo Class No CustomerInfo Informations. The following internal table describes the internal parameters.
    Language String No

    Information is the language in which the e-mail will be provided.
    TR: Turkish
    EN: English

    MPAY String No

    Free value
    Merchant’s unique transaction id can be sent via this parameter.

    CurrencyCode String No

    TRY/USD/EUR
    Currency Code : TRY/USD/EUR

    Port String No

    Port information of the end user performing the payment transaction

    IPAddress String Yes

    IP address information of the end user who has performed the payment transaction (entering the card number on the payment page and clicking the "make payment" button)

    PaymentContent String Yes

    The content of the payment transaction

    InstallmentCount Int Yes

    Installment Count:
    0: One shot
    3: 3 installment
    6: 6 installment
    9: 9 installment

    Error URL String Yes

    The end user will redirect to the URL after a failed operation The end user will be directed to this page after the "3DSEC" verification step

    SuccessURL String Yes

    The end user will redirect to the URL after successful operation The end user will be directed to this page after the "3DSEC" verification step

    Description String No

    Description of the payment transaction

    ExtraParam String No

    Parameter value to be used to trigger additional options in the method
    Should be left empty for this operation.

    PaymentTypeId int No

    Payment Method:
    1: One Shot
    2: Monthly subscription
    3: Weekly subscription
    18: Yearly subscription

  • Token Information
    Parameter Name Data Type Mandatory Description
    UserCode String Yes

    Merchant value is set by NomuPay

    Pin String Yes

    Pin value is set by NomuPay

  • CreditCardInfo Informations
    Parameter Name Data Type Mandatory Description
    CreditCardNo String Yes

    Credit card number to be used for payment
    Should be in ‘5400XXXXXXXXXXXX’ format

    OwnerName String Yes

    Name which is on the credit card
    Should be in ‘John Doe’ or ‘JOHN DOE’ format

    ExpireYear Int Yes

    Expire year of the credit card
    Should be in ‘2017’ format

    ExpireMonth Int Yes

    Expire month of the credit card
    Should be in ‘1,7,10,12, etc’ format.

    Cvv String Yes

    The CVV value on the back of the credit card

    Price Int Yes

    Amount of payment
    Real value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110.

  • CardTokenization Informations
    Parameter Name Data Type Mandatory Description
    RequestType Int Yes

    It can be sent as 0 or 1.
    0: No action.
    1: Performs payment and card registration

    CustomerId String Yes

    This value should be sent as "1" if card recording is wanted during payment processing. It is mandatory to send this value for the same situation.

    ValidityPeriod int Yes

    Credit card token record expiration date should be sent as 0. This field is required if you want to save the transaction credit card.

    CCTokenId Guid Yes

    Token value assigned by NomuPay for a previously created card. If this value is full, no credit card information needs to be entered.

  • CustomerInfo Information
    Parameter Name Data Type Mandatory Description
    CustomerName String No

    Name of the person to be informed

    CustomerSurname String No

    Surname of the person to be informed

    CustomerEmail String No

    E-mail of the person to be informed

Service Output Parameters


  • Service Output Parameters
    Parameter Name Data Type Description
    StatusCode Int

    Process Result
    0: Process Successful
    1: Process Failed

    ResultCode String

    NomuPay result code of the payment transaction

    ResultMessage String

    Description of ResultCode value.

    OrderObjectId Guid

    Unique id of the payment transaction
    This value is set automatically by NomuPay services.

    LastTransactionDate String

    Date of the payment transaction

    MaskedCreditCardNumber String

    Masked value of the credit card number which is used for payment transaction
    Will be in ‘XXXX YY** **** TTTT’ format

    MPAY String

    If the MPAY value is sent full during the process, the same value will be returned

    RedirectUrl String

    The end user will be redirected this URL to enter credit card information
    The end user must be directed to this URL for entering credi card information.

Payment Without 3D Secure

The method of payment without 3D Secure is a method used to complete credit card payments in one step. This method does not use the "3DSEC" step managed by the banks.

Payment Integration with 3D Secure, input information for Restful Service should be prepared in XML format and sent the following address with Post method.
https://www.nomupay.com.tr/SGate/Gate
Note: The url parameter sent to this field should be open to the "post" request.

Service Input Parameters


  • Input Information
    Parameter Name Data Type Mandatory Description
    ServiceType String Yes

    Static value: "CCProxy"

    OperationType String Yes

    Static value: "Sale"

    Token Token Class Yes

    Token Informations. The following internal table describes the internal parameters

    CreditCardInfo CreditCardInfo Class Yes CreditCardInfo Informations. The following internal table describes the internal parameters.
    CardTokenization CardTokenization Class Yes CardTokenization Informations. The following internal table describes the internal parameters.
    During credit card transaction, if the transaction card is requested to be recorded on the NomuPay system, or if a transaction is performed with a previously recorded card is requested, values under this class will be sent in full.
    CustomerInfo CustomerInfo Class No CustomerInfo Informations. The following internal table describes the internal parameters.
    Language String No

    Information is the language in which the e-mail will be provided.
    TR: Turkish
    EN: English

    MPAY String No

    Free value
    Merchant’s unique transaction id can be sent via this parameter.

    CurrencyCode String No

    TRY/USD/EUR
    Currency Code : TRY/USD/EUR

    Port String No

    Port information of the end user performing the payment transaction

    IPAddress String Yes

    IP address information of the end user who has performed the payment transaction (entering the card number on the payment page and clicking the "make payment" button)

    PaymentContent String Yes

    The content of the payment transaction

    InstallmentCount Int Yes

    Installment Count:
    0: One shot
    3: 3 installment
    6: 6 installment
    9: 9 installment

    Description String No

    Description of the payment transaction

    ExtraParam String No

    Parameter value to be used to trigger additional options in the method
    Should be left empty for this operation.

    PaymentTypeId int No

    Payment Method:
    1: One Shot
    2: Monthly subscription
    3: Weekly subscription
    18: Yearly subscription

  • Token Informations
    Parameter Name Data Type Mandatory Description
    UserCode String Yes

    Merchant value is set by NomuPay

    Pin String Yes

    Pin value is set by NomuPay

  • CreditCardInfo Informations
    Parameter Name Data Type Mandatory Description
    CreditCardNo String Yes

    Credit card number to be used for payment
    Should be in ‘5400XXXXXXXXXXXX’ format

    OwnerName String Yes

    Name which is on the credit card
    Should be in ‘John Doe’ or ‘JOHN DOE’ format

    ExpireYear Int Yes

    Expire year of the credit card
    Should be in ‘2017’ format

    ExpireMonth Int Yes

    Expire month of the credit card
    Should be in ‘1,7,10,12, etc’ format.

    Cvv String Yes

    The CVV value on the back of the credit card

    Price Int Yes

    Amount of payment
    Real value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110.

  • CardTokenization Informations
    Parameter Name Data Type Mandatory Description
    RequestType Int Yes

    It can be sent as 0 or 1.
    0: No action.
    1: Performs payment and card registration

    CustomerId String Yes

    This value should be sent as "1" if card recording is wanted during payment processing. It is mandatory to send this value for the same situation.

    ValidityPeriod int Yes

    Credit card token record expiration date should be sent as 0. This field is required if you want to save the transaction credit card.

    CCTokenId Guid Yes

    Token value assigned by NomuPay for a previously created card. If this value is full, no credit card information needs to be entered.

  • CustomerInfo Information
    Parameter Name Data Type Mandatory Description
    CustomerName String No

    Name of the person to be informed

    CustomerSurname String No

    Surname of the person to be informed

    CustomerEmail String No

    E-mail of the person to be informed

Service Output Parameters


  • Service Output Parameters
    Parameter Name Data Type Description
    StatusCode Int

    Process Result
    0: Process Successful
    1: Process Failed

    ResultCode String

    NomuPay result code of the payment transaction

    ResultMessage String

    Description of ResultCode value.

    OrderObjectId Guid

    Unique id of the payment transaction
    This value is set automatically by NomuPay services.

    LastTransactionDate String

    Date of the payment transaction

    MaskedCreditCardNumber String

    Masked value of the credit card number which is used for payment transaction
    Will be in ‘XXXX YY** **** TTTT’ format

    MPAY String

    If the MPAY value is sent full during the process, the same value will be returned

    RedirectUrl String

    The end user will be redirected this URL to enter credit card information
    The end user must be directed to this URL for entering credi card information.

NomuPay Common Payment Page

If you want to get the fastest payment for your business, you can use the NomuPay Common payment page. You can quickly and easily define your integration processes to using NomuPay common payment page.
This service allows credit card payments to be processed via the NomuPay Common Payment page.

NOMUPAY Static Common Payment Page

It is an appropriate solution for companies that have few and static number of products, product prices do not change frequently, do not want to do detailed system integration and do sales through a website.
Mobile payment is also possible in addition to credit card.

In this scenario, a product is defined by the authority of the company in the NomuPay panel and the static link presented for the product in the panel, is added to the sales page of the product in the website to be sold. This link directs the customer to the NomuPay common payment page for payment and redirects to the site at the end of the process.

For each new product, a new product must be created by authority of the merchant and these prices must be updated as the prices of the products change.

For NOMUPAY Static Common Payment Page Integrations, you can follow the steps below;

  1. The merchant login with the username and password on https://www.nomupay.com.tr address.
  2. Click on Products link in the information section.
  3. Click the Add New link on the left.
  4. Fill in the information about the product and click the Add button.
  5. The created product will be approved by NomuPay (by sending a request to tr.bd@nomupay.com).
  6. Click on the Products link on the panel, click on the product detail icon of the related product.
  7. In the page that is opened, the Sales Address link in the Web Sales Channel box is used for sales in the merchant's website.
    • The sample sales address is as follows:
    • A unique ID can be added for each transaction according as the preference of the merchant. For this, the value must be added end of the the address with the parameter mpay: You will be able to query this mpay value or to match your transaction number with the collection number.
  8. After the customer successfully completes the payment, the customer will be forwarded back to the adrese which is described by the Successful URL at the following table. In this URL the following parameters are added by NomuPay Payments:
    pid Process Number(Old Format)
    mpy The value that can be used for transaction tracking defined by the member business and submitted during the transaction. (NO “mpay” parameter!)
    sid Subscription number (this value will be blank for non-subscription operations) (Old Format)
    order Order Number (New Format)
    subscriber Subscriber Number(New Format)
    The example result URL is: The description of the fields required when completing the product information is as follows:
    SMS Company Name It is the company name to be seen by the customer. Note: Careful selection is required as this name will appear on the common payment page and on the confirmation SMS.
    Product name It is the product name to be seen by the customer. (Örnek: Wordpress Theme Sales, Example.com 1 Month Subscription) Note: Careful selection is required as this name will appear on the common payment page.
    Product Category The services / products sold by NomuPay are divided into categories. It is important to choose the right category, because the commission rate of each category is different. If the wrong category is selected and the transaction is made, penalties are applied according to the contract. You can visit our website for current rates.
    Sales Type It is divided into two branhes which is Single Product Sales and Subscription. When Single Product Sales is selected, the system will be charged the designated fee only once. When a subscription is selected, the same amount on a monthly or weekly will be charged on a regular without approval again.
    Description It is information about the content of the product. We remind you that this is very important for customer satisfaction.
    Product Price The price of the product / service you will sell with NomuPay. First, the Lira part and then penny part is written.
    Customer Service E-Posta This is the mailing address of the unit that will provide support for customers and help with payments and orders.
    Web Address The address of the website where you will publish the product. After adding the product, the website will be checked by NomuPay.
    Success URL The customer will be directed to this Internet address when payment is successfully completed. (Example: http://www.example.com/paymentsuccessful.aspx)
    Failed URL The customer will be directed to this Internet address when payment is unsuccessful. (Example: http://www.example.com/unsuccessful.aspx)

NOMUPAY Dynamic Common Payment Page

On the dynamic common payment page, the payment form is provided by NOMUPAY. The merchant does not need to create a payment form. Using the NomuPay common payment page, you can quickly and easily complete your integration process.

Payment with 3D Secure

The payment method with 3D Secure is a process used to complete credit card payment transactions via the bank's "3DSEC" verification page.
The end user must be directed to complete the 3DSEC step to delivered URL via the response message.

Payment Integration with 3D Secure, input information for Restful Service should be prepared in XML format and sent the following address with Post method.
https://www.nomupay.com.tr/SGate/Gate
Note: The url parameter sent to this field should be open to the "post" request.

Service Input Parameters


  • Input Informations
    Parameter Name Data Type Mandatory Description
    ServiceType String Yes

    Static values: "WDTicket"

    OperationType String Yes

    Static value: "Sale3DSURLProxy"

    Token Token Class Yes

    Token Informations. The following internal table describes the internal parameters.

    CustomerInfo CustomerInfo Class No CustomerInfo Informations. The following internal table describes the internal parameters.
    Language String No

    Information is the language in which the e-mail will be provided.
    TR: Turkish
    EN: English

    Price Int Yes

    Amount of payment
    Real value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110

    MPAY String No

    Merchant’s unique transaction id can be sent via this parameter.

    CurrencyCode String No

    TRY/USD/EUR
    Currency Code : TRY/USD/EUR

    Description String Yes

    Description of the payment transaction.

    ErrorURL String Yes

    The end user will redirect to the URL after a failed operation
    The end user will be directed to this page after the "3DSEC" verification step

    SuccessURL String Yes

    The end user will redirect to the URL after successful operation The end user will be directed to this page after the "3DSEC" verification step

    ExtraParam String No

    Parameter value to be used to trigger additional options in the method

    If you want the credit card number to appear masked on the payment screen, if IsCCMasked = 1 is specified, the credit card number appears on the payment page

    If you want the CVV information to appear as masked on the payment screen, if IsCVVMasked = 1 is specified, the CVV information appears masked.

    If you want the credit card number and CVV information to appear masked, you must specify IsCCMasked = 1 & IsCVVMasked = 1.

    If ExtraParam parameter is sent blank, credit card number and CVV information are not masked on the screen.

    PaymentContent String Yes

    The content of the payment transaction

    PaymentTypeId Int No

    Payment Type
    1: One shot
    2: Monthly Subscription
    3: Weekly Subscription
    18: Yearly subscription

    InstallmentOptions Int No

    Installment count:
    0: One shot
    3: 3 Installments
    6: 6 Installments
    9: 9 Installments

  • Token Information
    Parameter Name Data Type Desciption
    UserCode String

    Merchant value is set by NomuPay

    Pin String

    Pin value is set by NomuPay

  • CustomerInfo Information
    Parameter Name Data Type Mandatory Description
    CustomerName String No

    Name of the person to be informed

    CustomerSurname String No

    Surname of the person to be informed

    CustomerEmail String No

    E-mail of the person to be informed

Service Output Parameters


  • Service Output Parameters
    Parameter Name Data Type Description
    StatusCode Int

    Process Result
    0: Process Successful
    1: Process Failed

    ResultCode String

    NomuPay result code of the 3D payment transaction

    ResultMessage String

    Description of ResultCode value.
    This description can be shared with the end user.

    RedirectUrl String

    The end user will be redirected this URL to enter credit card information
    The end user must be directed to this URL for entering credit card information

Parameter Name Descripton
OrderId

Completed payment Order ID information

MPAY

When the payment transaction is started, Mypay values will sent back to NomuPay exactly.

Statuscode

Result of Payment Transaction

ResultCode

NomuPay result code of the 3D payment transaction

ResultMessage

ResultCode value desciption

LastTransactionDate

Date of the payment transaction

MaskedCCNo

Masked value of the credit card number which is used for payment transaction

CCTokenId

Unique process Id created by NomuPay for payment process

ExtraParam

Extra information about the payment process

Payment Without 3D Secure

The method of payment without 3D Secure is a method used to complete credit card payments in one step. This method does not use the "3DSEC" step managed by the banks.

Payment Integration without 3D Secure, input information for Restful Service should be prepared in XML format and sent the following address with Post method.
https://www.nomupay.com.tr/SGate/Gate
Note: The url parameter sent to this field should be open to the "post" request.

Service Input Parameters


  • Input Information
    Parameter Name Data Type Mandatory Description
    ServiceType String Yes

    Static value: "WDTicket"

    OperationType String Yes

    Static value : "SaleURLProxy"

    Token Token Class Yes

    Token Informations. The following internal table describes the internal parameters.

    CustomerInfo CustomerInfo Class No CustomerInfo Informations. The following internal table describes the internal parameters.
    Language String No

    Information is the language in which the e-mail will be provided.
    TR: Turkish
    EN: English

    Price Int Yes

    Amount of payment
    Real value should be multiplied by 100. No decimal values. E.g. 1,10 TL should be sent as 110.

    MPAY String No

    Merchant’s unique transaction id can be sent via this parameter.

    CurrencyCode String No

    TRY/USD/EUR
    Currency Code : TRY/USD/EUR

    Description String Yes

    Description of the payment transaction

    ErrorURL String Yes

    The end user will redirect to the URL after a failed operation
    The end user will be directed to this page after the "3DSEC" verification step

    SuccessURL String Yes

    The end user will redirect to the URL after successful operation
    The end user will be directed to this page after the "3DSEC" verification step

    ExtraParam String No

    Parameter value to be used to trigger additional options in the method

    If you want the credit card number to appear masked on the payment screen, if IsCCMasked = 1 is specified, the credit card number appears on the payment page

    If you want the CVV information to appear as masked on the payment screen, if IsCVVMasked = 1 is specified, the CVV information appears masked.

    If you want the credit card number and CVV information to appear masked, you must specify IsCCMasked = 1 & IsCVVMasked = 1.

    If ExtraParam parameter is sent blank, credit card number and CVV information are not masked on the screen.

    PaymentContent String Yes

    The content of the payment transaction

    PaymentTypeId Int No

    Payment Type
    1: One shot
    2: Monthly Subscription
    3: Weekly Subscription
    18: Yearly subscription

    InstallmentOptions Int No

    Installment count:
    0: One shot
    3: 3 Installments
    6: 6 Installments
    9: 9 Installments

  • Token Information
    Parameter Name Data Type Description
    UserCode String

    Merchant value is set by NomuPay

    Pin String

    Pin value is set by NomuPay

  • CustomerInfo Information
    Parameter Name Data Type Mandatory Description
    CustomerName String No

    Name of the person to be informed

    CustomerSurname String No

    Surname of the person to be informed

    CustomerEmail String No

    E-mail of the person to be informed

Service Output Parameters


  • Service Output Parameters
    Parameter Name Data Type Description
    StatusCode Int

    Process Result Without 3D Result
    0: Process Successful
    1: Process Failed

    ResultCode String

    NomuPay result code of the payment transaction

    ResultMessage String

    Description of ResultCode value.
    This description can be shared with end-user.

    RedirectUrl String

    The end user will be redirected this URL to enter credit card information
    The end user must be directed to this URL for entering credi card information.

Parameter Name Description
OrderId

Completed payment Order ID information

MPAY

When the payment transaction is started, Mypay values will sent back to NomuPay exactly.

Statuscode

Result of Payment Transaction

ResultCode

NomuPay result code of the 3D payment transaction

ResultMessage

ResultCode value desciption

LastTransactionDate

Date of the payment transaction

MaskedCCNo

Masked value of the credit card number which is used for payment transaction

CCTokenId

Unique process Id created by NomuPay for payment process

ExtraParam

Extra information about the payment process

Sample Service Request Codes