Documentação de integração com o SDK iOS (versão 2.0)
Objective-C Swift C Shell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
objc
swift
.gitignore
README.md
README_en.md
git_push.sh

README.md

StoneSDK

Objective-C Swift

SDK de integração para iOS.

This document in English 🇬🇧🇬🇧🇬🇧🇬🇧🇬🇧🇬🇧🇬🇧

Download do último release pode ser feito em releases.

Funcionalidades

  • Ativação do Stone Code
  • Criação de sessão com o pinpad
  • Download / carragamento das tabelas AID e CAPK
  • Envio transações
  • Cancelamento de transações
  • Listagem das transações
  • Envio de recibo por email

Requisitos

  • iOS 8.0+
  • Xcode 7.1+

Contato

Em caso de problemas abra uma issue.

Instalação

Antes de começar a usar o StoneSDK é necessario seguir alguns procedimentos.

No target do projeto acesse a guia General e em Embedded Binaries adicione o StoneSDK.framework (é necessario que o arquivo esteja no diretorio do projeto).

Ainda no target do projeto, na guia Info adicione a propriedade Supported external accessory protocols em Custom iOS Target Properties e adicione os protocolos dos dispositivos bluetooth que terão permissão de se comunicar com o aplicativo.

É necessário que a aplicação habilite TLS v1.2 para a comunicação com nossos servidores. Para isso adicione as linhas de código a seguir no Info.plist (clique no arquivo Info.plist com o botão direito do mouse e selecione Open As > Source Code):

<key>NSAppTransportSecurity</key>
	<dict>
		<key>NSExceptionDomains</key>
		<dict>
			<key>stone.com.br</key>
			<dict>
				<key>NSExceptionMinimumTLSVersion</key>
				<string>TLSV1.2</string>
				<key>NSExceptionRequiresForwardSecrecy</key>
				<false/>
				<key>NSIncludesSubdomains</key>
				<true/>
			</dict>
		</dict>
	</dict>

Na guia Build Settings, em Build Options, selecione No para a configuração Enable Bitcode.

Adicione o script abaixo em Build Phases (Em Build Phases, clique sinal de "mais" e selecione New Run Script Phase).

FRAMEWORK="StoneSDK"
FRAMEWORK_EXECUTABLE_PATH="${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/$FRAMEWORK.framework/$FRAMEWORK"
EXTRACTED_ARCHS=()
for ARCH in $ARCHS
do
lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"
EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")
done
lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"
rm "${EXTRACTED_ARCHS[@]}"
rm "$FRAMEWORK_EXECUTABLE_PATH"
mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"

O mesmo deverá ficar como na imagem abaixo:

info.plist

Ambiente de homologação

Para usar o ambiente de homologação, adicione a key Stone Homologation como tipo Boolean no Info.plist do projeto. Use YES ou NO para ligar ou desligar.

Exemplos de Código