e-SiTef

e-SiTef

  • Portal do Desenvolvedor
  • Fale Conosco
  • English

›REST Payment

REST Payment

  • Overview
  • Quick start
  • Transaction creation service
  • Payment effectuation service
  • Payment confirmation service
  • Transaction status query
  • Multiple transactions status query
  • Card query service
  • Payment with multiple payment methods service
  • Payment with multiple payment methods confirmation service
  • External origin payment confirmation service

REST Store

  • Overview

REST Cancel

  • Flow
  • Quick start
  • Cancel via host
  • Cancel external origin
  • Cancel creation service
  • Cancel service

REST Pre-Authorization

  • Overview
  • Quick start
  • Pre-Authorization Creation Service
  • Pre-Authorization effectuation service
  • Pre-Authorization Status Query
  • Pre-Authorization Editing Service
  • Pre-Authorization Editing External Origin Service
  • Pre-Authorization Increment Service
  • Card Query Service
  • Pre-Authorization Capture Service
  • Pre-Authorization Capture External Origin Service

REST Schedule

  • Overview
  • Quick start
  • Transaction creation service
  • Schedule activation service
  • Execution of the scheduled payments
  • Schedule editing flow
  • Quick start: schedule editing
  • Schedule editing creation service
  • Schedule editing service

REST Recharge

  • Overview
  • Quick start
  • Recharge creation service
  • List dealers service
  • List branch data service
  • Recharge effectuation service
  • Recharge confirmation service
  • Recharge query service

HTML Payment

  • Overview
  • Quick start
  • Initializing a payment transaction
  • Status notification
  • Transaction status query
  • Payment with card storage
  • Pages Customization
  • Payment link
  • Split Payment
  • Payment with multiple payment methods
  • 3DS 2.0 Integration

HTML Pre-Authorization

  • Overview

HTML Recharge

  • Overview
  • Quick start
  • Initializing a Recharge transaction

REST Generic Operations

  • Overview
  • Token creation service
  • Generic operation service

JavaScript Payment

  • Overview
  • Quick start
  • Transaction creation service
  • Virtual store's payment page
  • Transaction query service

JavaScript Store

  • Overview
  • Quick start
  • Transaction creation service
  • Virtual store's page

Merchant Web Page

  • Introduction
  • Access to web page
  • Two-Factor Authentication
  • User Configuration
  • Configure Authorizers
  • Transaction Report
  • Daily Summary Report
  • Store Report
  • Recharge Report
  • Analytical Report
  • Transaction Cancellation
  • Schedule
  • Configure Risk Analysis
  • Configure Order Authorizers
  • Users Administration
  • Generate Payment Link

Retry

  • Overview
  • Flow
  • Retry and Schedule

SiTef Routings

  • Bradescard
  • Cetelem
  • GetnetLac
  • Orbitall
  • Vero
  • Bin
  • Sipag

Non SiTef Routings

  • Banco do Brasil
  • Banrisul Vero
  • Cielo e-Commerce
  • EPX
  • e.Rede Rest
  • Fepas HUB
  • Getnet WS
  • GlobalPayments WS
  • IPG
  • Itaú Shopline
  • Mercado Pago
  • PagSeguro
  • PayPal
  • SafraPay
  • Stone WS

Digital Wallet

  • Overview
  • VEE Digital Wallet via CardSE
  • Pix via CardSE
  • Google Pay
  • Visa Checkout
  • Masterpass
  • Samsung Pay
  • Apple Pay
  • Configuration for Digital Wallets

Anti-Fraud Integration

  • Overview
  • Risk analysis service on the HTML Interface
  • Risk analysis response
  • Manual review flow
  • Fraud notification service
  • ClearSale
  • CyberSource
  • Konduto
  • Fraud Detect

General Information

  • Authorizers
  • Digital Certificates
  • API codes
  • Soft Descriptor
  • Signature authentication

Batch Registrations

  • Batch Store Registration
  • Batch Routing Configuration

REST Merchants Registration

  • Overview
  • Quick start
  • Token creation service
  • Merchant creation service
  • Merchant editing service
  • Merchant query service
  • Merchant status query service
  • List merchants service
  • API codes

3DS Server

  • Overview
  • Quick start
  • Transaction creation service
  • Authentication service
  • Transaction query service
  • Challenge messages
  • Decoupled notification
  • Initiating a 3DS Method
  • API codes

Payment with multiple payment methods confirmation service

After creating and authorizing a multiple payment methods payment pending confirmation, the merchant must call the multiple payment methods payment confirmation service to confirm or undo the payment using the same NIT obtained on the first step of the flow.

Flow

The multiple payment methods payment confirmation flow has two differences when compared to the traditional confirmation.

The first difference is that there will be two transactions related to a single operation and each one of them is used to confirm the payment of one of the chosen payment methods.

The second difference is that multiple payment methods payment confirmation response is composed by each transaction response. It means that each of the transactions' responses can affect the results of the other one.

We will cover the e-SiTef predicted scenarios below.

Successful confirmation

First confirmation fails

When the first confirmation fails, the second transaction will be undone. An issue will be registered and the merchant may contact e-SiTef's support team if they find it necessary.

Response example

{
    "code": "1013",
    "message": "Error processing multiple payment methods",
    "confirmations": [
        {
            "code": "259",
            "message": "Denied transaction",
            "payment": {
                "authorizer_code": "409",
                "authorizer_message": "Brand / card type is invalid or not supported [Cód.: 5996]",
                "status": "PPC",
                "acquirer_id": "414"
            }
        },
        {
            "code": "0",
            "message": "OK. Transaction successful.",
            "payment": {
                "authorizer_code": "200",
                "authorizer_message": "Function performed error-free [Cód.: 00]",
                "status": "PPN",
                "acquirer_id": "414"
            }
        }
    ]
}

Second confirmation fails

When the second confirmation fails, the first transaction will be already confirmed. Therefore, it must be manually cancelled if the merchant finds it necessary by using either the REST cancellation call or the Merchant Web Page. An issue will be registered and the merchant may contact e-SiTef's support team if they find it necessary.

Response example

{
    "code": "1013",
    "message": "Error processing multiple payment methods",
    "confirmations": [
        {
            "code": "0",
            "message": "OK. Transaction successful.",
            "payment": {
                "authorizer_code": "200",
                "authorizer_message": "Function performed error-free [Cód.: 00]",
                "status": "CON",
                "acquirer_id": "414"
            }
        },
        {
            "code": "259",
            "message": "Denied transaction",
            "payment": {
                "authorizer_code": "409",
                "authorizer_message": "Brand / card type is invalid or not supported [Cód.: 5996]",
                "status": "PPC",
                "acquirer_id": "414"
            }
        }
    ]
}

Call details

  • Resource: /v1/payments/multiple/{nit}
  • HTTP Method: PUT
  • Request format: query string
  • Response format: JSON
  • Header parameters:
ParameterDescriptionFormatMandatory
merchant_idMerchant code on e-SiTef. The production and certification codes will be different.< 15 ANYES
merchant_keyMerchant authentication key on e-SiTef. The production and certification keys will be different.< 80 ANYES

Examples

Below is an example of the multiple payment methods payment confirmation service call using the cURL tool.

Requisição:

curl
--request PUT "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/payments/multiple/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr?confirm=true"
--header "merchant_id:xxxxxxxxxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--verbose

Resposta:

{
    "code": "0",
    "message": "OK. Transaction successful.",
    "confirmations": [
        {
            "code": "0",
            "message": "OK. Transaction successful.",
            "payment": {
                "authorizer_code": "130",
                "status": "CON",
                "acquirer_id": "5"
            }
        },
        {
            "code": "0",
            "message": "OK. Transaction successful.",
            "payment": {
                "authorizer_code": "130",
                "status": "CON",
                "acquirer_id": "5"
            }
        }
    ]
}

Request parameters

The table below describes the request parameters of the payment with multiple payment methods confirmation service:

ParameterDescriptionFormatMandatory
confirmThis field must be sent with the value true if you want to confirm the transaction, or false, if you want to undo it.< 5 T/FYES

Response parameters

If successful, the HTTP response code will be 200. Any other code must be interpreted as an error. The table below describes the response parameters of the payment confirmation service:

ParameterDescriptionFormat
codeMultiple payment methods operation e-SiTef response code. Any code different from 0 means failure. [Learn more.](/api/docs/ing/codigos-da-api#response-codes< 4 N
messageMultiple payment methods operation e-SiTef response message.< 500 AN
confirmations[]
codee-SiTef response code for this payment method. Any code different from 0 means failure. Learn more..< 4 N
messagee-SiTef response message for this payment method.< 500 AN
payment
statusStatus of the payment transaction on e-SiTef. Learn more.= 3 AN
authorizer_codeAuthorizer response code. This field is not returned if this is not the first call to the operation.< 10 AN
authorizer_messageAuthorizer response message. This field is not returned if this is not the first call to the operation.< 500 AN
acquirer_idCode of the acquirer used on the transaction. This field is not returned if this is not the first call to the operation.< 4 N
← Payment with multiple payment methods serviceExternal origin payment confirmation service →
  • Flow
    • Successful confirmation
    • First confirmation fails
    • Second confirmation fails
  • Call details
  • Examples
  • Request parameters
  • Response parameters
e-SiTef
Relacionamento com o cliente
+55 (11) 3170-5300+55 (11) 4766-8000comercial@softwareexpress.com.br
Acessos
Portal do DesenvolvedorPortal e-SiTefVersão para impressão
Copyright © 2021 Software Express Informática Ltda - Todos os direitos reservados