GarantiBBVA E-Ticaret Developer Portal

E-commerce API Market

You can find all the details you need for integration within the E-Commerce API Market.
Find API

E-Commerce Solutions

Virtual POS
Switch
Card Storage
Security Platform
Garantipay 2.0

Find Out More

Find the API that You Need

Sales

It includes APIs required for all your sales transactions. You can find your sales transactions such as “Advance Sales”, “Installation Sales”, “Award Inquiry” and “Pre-Authorization”.
See API's

Sales

It includes APIs required for all your sales transactions. You can find your sales transactions such as “Advance Sales”, “Installation Sales”, “Award Inquiry” and “Pre-Authorization”.
Void

It contains the APIs required for your voids. You can find cancellations such as “Void, “Partial Void” and “Pre-Authorization Void”.
See API's

Void

It contains the APIs required for your voids. You can find cancellations such as “Void, “Partial Void” and “Pre-Authorization Void”.
Closing

It contains the APIs required for all your closing operations. You can find your closing processes such as “Pre-Authorization Closing”.
See API's

Closing

It contains the APIs required for all your closing operations. You can find your closing processes such as “Pre-Authorization Closing”.
Refund

It contains the APIs required for all your refunds. You can find all your refund transactions such as “Refunds”, “Partial Refunds” and “Award Refunds”.
See API's

Refund

It contains the APIs required for all your refunds. You can find all your refund transactions such as “Refunds”, “Partial Refunds” and “Award Refunds”.
Inquiry

It contains the APIs required for all your query operations. You can find all your inquiries such as “Bonus Inquiry”, “Transaction Inquiry”, Transaction Detail Inquiry” and “Date Range Inquiry”.
See API's

Inquiry

It contains the APIs required for all your query operations. You can find all your inquiries such as “Bonus Inquiry”, “Transaction Inquiry”, Transaction Detail Inquiry” and “Date Range Inquiry”.
Additional Features

It contains APIs required for additional fields you may need. You can find all your additional field operations such as "Address Submission", "Product Information Submission" and "Custom Field Submission".
See API's

Additional Features

It contains APIs required for additional fields you may need. You can find all your additional field operations such as "Address Submission", "Product Information Submission" and "Custom Field Submission".
Common Payment

It includes APIs required for all common payment transactions. You can find all your common payment transactions such as “DCC”, “Multi Currency”, “Distribution Card” and “Future Sale”.
See API's

Common Payment

It includes APIs required for all common payment transactions. You can find all your common payment transactions such as “DCC”, “Multi Currency”, “Distribution Card” and “Future Sale”.
Open Source Extensions

It contains APIs required for Open Source Extensions. You can find platforms with ready integration of Garanti BBVA Virtual POS.
See API's

Open Source Extensions

It contains APIs required for Open Source Extensions. You can find platforms with ready integration of Garanti BBVA Virtual POS.

Sales

It includes APIs required for all your sales transactions. You can find your sales transactions such as “Sales with Token”, “Sales with 3D Token”, “Sales without Token” and “Sales without 3D Token”.
See API's

Sales

It includes APIs required for all your sales transactions. You can find your sales transactions such as “Sales with Token”, “Sales with 3D Token”, “Sales without Token” and “Sales without 3D Token”.
Preauth

It includes APIs required for all your preauth transactions. You can find your preauth transactions such as “Preauth with Token”, “Preauth with 3D Token”, “Preauth without Token” and “Preauth without 3D Token”.
See API's

Preauth

It includes APIs required for all your preauth transactions. You can find your preauth transactions such as “Preauth with Token”, “Preauth with 3D Token”, “Preauth without Token” and “Preauth without 3D Token”.
Common Payment

It includes APIs required for all common payment transactions. You can find all your common payment transactions such as “Pay with Credit Card”, “Pay with Garanti Pay”.
See API's

Common Payment

It includes APIs required for all common payment transactions. You can find all your common payment transactions such as “Pay with Credit Card”, “Pay with Garanti Pay”.
Collection by Code

You can find information and APIs about the "Collection by Code" payment solution in the Switch.
See API's

Collection by Code

You can find information and APIs about the "Collection by Code" payment solution in the Switch.
Postauth

It includes APIs required for all postauth transactions.
See API's

Postauth

It includes APIs required for all postauth transactions.
Void

It includes APIs required for all void transactions.
See API's

Void

It includes APIs required for all void transactions.
Refund

It includes APIs required for all refund transactions.
See API's

Refund

It includes APIs required for all refund transactions.
Order Inquiry

It includes APIs required for order querying.
See API's

Order Inquiry

It includes APIs required for order querying.

Score Inquiry

It includes APIs required for your score query operations.
See API's

Score Inquiry

It includes APIs required for your score query operations.
Score Inquiry Merchant Result

It includes APIs required for your score query merchant results transactions.
See API's

Score Inquiry Merchant Result

It includes APIs required for your score query merchant results transactions.

Token Gen

It contains APIs required for all token gen operations. You can find all your token gen operations such as "Token Gen", "Token Gen with 3D" and "Token Gen Via Card Login Screen".
See API's

Token Gen

It contains APIs required for all token gen operations. You can find all your token gen operations such as "Token Gen", "Token Gen with 3D" and "Token Gen Via Card Login Screen".

GP Data Status Updated Request

When there is an update regarding a GarantiPay transaction, the Ecommerce API Platform calls this service that the business will provide.
See API's

GP Data Status Updated Request

When there is an update regarding a GarantiPay transaction, the Ecommerce API Platform calls this service that the business will provide.
GP Data Request

This is the request where the merchant transfers information about the order to the Garanti Ecommerce Platform. This request, which includes financial information in the GarantiPay flow, must be made via the merchant's backend servers for both web2app and app2app flows.
See API's

GP Data Request

This is the request where the merchant transfers information about the order to the Garanti Ecommerce Platform. This request, which includes financial information in the GarantiPay flow, must be made via the merchant's backend servers for both web2app and app2app flows.
Order INQ

When merchants want to query transaction results, they can use the Ecommerce API Platform order query request. When merchants receive a timeout error or other error, they can also send an order query for a successful transaction.
See API's

Order INQ

When merchants want to query transaction results, they can use the Ecommerce API Platform order query request. When merchants receive a timeout error or other error, they can also send an order query for a successful transaction.
Order Cancel

With this API, authorization (auth) transactions, pre-authorization (preauth), closure (postauth) and refund transactions can be canceled before the end of the day. Only GarantiPay 2.0 transactions can be canceled from this service.
See API's

Order Cancel

With this API, authorization (auth) transactions, pre-authorization (preauth), closure (postauth) and refund transactions can be canceled before the end of the day. Only GarantiPay 2.0 transactions can be canceled from this service.
Order Cancel

Depending on the Virtual POS bank to be used with this API, a refund can be made for the total amount or a portion of the amount for authorization (auth) and closing (postauth) transactions that enter the end of the day.
See API's

Order Cancel

Depending on the Virtual POS bank to be used with this API, a refund can be made for the total amount or a portion of the amount for authorization (auth) and closing (postauth) transactions that enter the end of the day.
Order Cancel

If pre-auth is passed as an operation in a GarantiPay 2.0 transaction, the post-auth (closing) transaction is performed with this API. This API is only valid for pre-auth transactions that have passed through GarantiPay 2.0.
See API's

Order Cancel

If pre-auth is passed as an operation in a GarantiPay 2.0 transaction, the post-auth (closing) transaction is performed with this API. This API is only valid for pre-auth transactions that have passed through GarantiPay 2.0.
Payment Options Service

The merchant must send the paymentOptionsUrl value in the gpdatarequest message to manage transaction options based on BIN numbers.
See API's

Payment Options Service

The merchant must send the paymentOptionsUrl value in the gpdatarequest message to manage transaction options based on BIN numbers.
Signature Message

Ecommerce API Platform uses JWS (Json Web Signature) standard to verify the authenticity of messages.
See API's

Signature Message

Ecommerce API Platform uses JWS (Json Web Signature) standard to verify the authenticity of messages.
Virtual POS JWK File Creation, Listing and Downloading

Contains the necessary documentation for Virtual POS JWK File Creation, Listing and Downloading operations.
See API's

Virtual POS JWK File Creation, Listing and Downloading

Contains the necessary documentation for Virtual POS JWK File Creation, Listing and Downloading operations.
Switch Management Screens

With the Switch Management Portal screens, information in the Switch system can be viewed, transactions and orders can be listed, Switch password updates and bank definitions can be made.
See API's

Switch Management Screens

With the Switch Management Portal screens, information in the Switch system can be viewed, transactions and orders can be listed, Switch password updates and bank definitions can be made.
Mobile Integration

It is the documentation that contains the necessary instructions for IOS and Android mobile integration.
See API's

Mobile Integration

It is the documentation that contains the necessary instructions for IOS and Android mobile integration.

Easy to Integrate, Easy to Develop.

Technical Documents and Guidelines
API Documentations
Test Cards
Error Codes
Frequently Asked Questions

Frequently Asked Questions

What should we do when we receive the error message "User password is incorrect" in the ErrorMsg Tag in the Advance Sale Without 3D Transaction?

<Response>
<Source>GVPS</Source>
<Code>92</Code>
<ReasonCode>0651</ReasonCode>
<Message>Declined</Message>
<ErrorMsg>User password is incorrect</ErrorMsg>
<SysErrMsg>ErrorId: 0651</SysErrMsg>

The received error is received in cases where the fields that make up the value of the hash data sent in your coding do not match the values defined in the system or the coding posted. We kindly ask you to check these fields and try the operation again, and if the error persists, send us the fields that make up the hash value and the hash value you have created.

Also, please reset your PROVAUT and 3D password used in coding and update it in coding.

mdstatus:7, mderrormessage: "Workplace Type Not Supported." What can I do for the error?

An error is received because the model you want to use is not defined in our bank system. The definition should be made by sending the model you want to work with to the eticaretdestek@garantibbva.com.tr e-mail address.

What can I do for the mdstatus:7, mderrormessage: "Incorrect Security Code" error?

This error message can have 3 different causes;

1. It may be caused by incorrect passwords used in the software. (PROVAUT/PROVOOS/3D passwords)

2. You should check your hash structure. It may be caused when the hash data is calculated incorrectly.

3. You should check the hidden/input fields in the code you posted. It may be used in an empty or incorrect format.

Read More

We would love to hear from you. Do you have problems/questions about services ? Send us detailed email about it ?

Send Us a Question Send Us a Question