All URIs are relative to https://api-sandbox.synctera.com/v0
Method | HTTP request | Description |
---|---|---|
authenticate3_ds | POST /external_cards/authenticate_3ds | Authenticate 3DS |
create_external_card_from_token | POST /external_cards/tokens | Create External Card from token |
create_external_card_transfer | POST /external_cards/transfers | Create External Card Transfer |
create_external_card_transfer_reversal | POST /external_cards/transfers/{transfer_id}/reversals | Create External Card Transfer Reversal |
delete_external_card | DELETE /external_cards/{external_card_id} | Delete External Card |
get_external_card | GET /external_cards/{external_card_id} | Get External Card |
get_external_card_transfer | GET /external_cards/transfers/{transfer_id} | Get External Card Transfer |
initialize3_ds | POST /external_cards/initialize_3ds | Initialize 3DS |
list_external_card_transfers | GET /external_cards/transfers | List External Card Transfers |
list_external_cards | GET /external_cards | List External Cards |
lookup3_ds | POST /external_cards/lookup_3ds | Lookup 3DS |
update_external_card | PATCH /external_cards/{external_card_id} | Update External Card |
authenticate3_ds(authenticate3ds_request, opts)
Authenticate 3DS
Validates the results of an External Card Transfer 3DS authentication challenge.
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
authenticate3ds_request = Synctera::Authenticate3dsRequest.new({challenge_jwt: 'challenge_jwt_example', id: '7d943c51-e4ff-4e57-9558-08cab6b963c7'}) # Authenticate3dsRequest | Details of the External Card Transfer 3DS authentication challenge validation.
opts = {
idempotency_key: '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.
}
begin
# Authenticate 3DS
result = api_instance.authenticate3_ds(authenticate3ds_request, opts)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->authenticate3_ds: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> authenticate3_ds_with_http_info(authenticate3ds_request, opts)
begin
# Authenticate 3DS
data, status_code, headers = api_instance.authenticate3_ds_with_http_info(authenticate3ds_request, opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <Authenticate3dsResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->authenticate3_ds_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
authenticate3ds_request | Authenticate3dsRequest | Details of the External Card Transfer 3DS authentication challenge validation. | |
idempotency_key | String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry. | [optional] |
- Content-Type: application/json
- Accept: application/json, application/problem+json
create_external_card_from_token(external_card_request, opts)
Create External Card from token
Create an External Card from token. The token and cardholder name are obtained through the iFrame. The token must be used within 5 minutes or else it will expire. If a Business ID is provided, address verification will be performed against the legal address of the business. Otherwise, the legal address of the Customer will be used. In either case, the name of the Customer will be used to match against the cardholder name. Each unique External Card is limited to a single Customer, so once an External Card is created for a Customer, it cannot be used for any other Customers, even if the card is deleted. Given there is a limited number of test cards, to allow easier testing, this restriction is relaxed in the sandbox environment.
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
external_card_request = Synctera::ExternalCardRequest.new({customer_id: '7d943c51-e4ff-4e57-9558-08cab6b963c7', name: 'Jean Valjean', token: 'token_example'}) # ExternalCardRequest | Details of the External Card to create
opts = {
idempotency_key: '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.
}
begin
# Create External Card from token
result = api_instance.create_external_card_from_token(external_card_request, opts)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->create_external_card_from_token: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> create_external_card_from_token_with_http_info(external_card_request, opts)
begin
# Create External Card from token
data, status_code, headers = api_instance.create_external_card_from_token_with_http_info(external_card_request, opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <ExternalCardResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->create_external_card_from_token_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
external_card_request | ExternalCardRequest | Details of the External Card to create | |
idempotency_key | String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry. | [optional] |
- Content-Type: application/json
- Accept: application/json, application/problem+json
create_external_card_transfer(transfer_request, opts)
Create External Card Transfer
Create an External Card Transfer
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
transfer_request = Synctera::TransferRequestPull.new({amount: 37, currency: 'USD', external_card_id: '7d943c51-e4ff-4e57-9558-08cab6b963c7', originating_account_id: '7d943c51-e4ff-4e57-9558-08cab6b963c7', type: Synctera::TransferTypeRequest::PULL}) # TransferRequest | Details of the External Card Transfer to create
opts = {
idempotency_key: '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.
}
begin
# Create External Card Transfer
result = api_instance.create_external_card_transfer(transfer_request, opts)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->create_external_card_transfer: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> create_external_card_transfer_with_http_info(transfer_request, opts)
begin
# Create External Card Transfer
data, status_code, headers = api_instance.create_external_card_transfer_with_http_info(transfer_request, opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <TransferResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->create_external_card_transfer_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
transfer_request | TransferRequest | Details of the External Card Transfer to create | |
idempotency_key | String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry. | [optional] |
- Content-Type: application/json
- Accept: application/json, application/problem+json
create_external_card_transfer_reversal(transfer_id, transfer_reversal_request, opts)
Create External Card Transfer Reversal
Create an External Card Transfer Reversal
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
transfer_id = '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | The unique identifier of a transfer
transfer_reversal_request = Synctera::TransferReversalRequest.new({amount: 37, currency: 'USD'}) # TransferReversalRequest | Details of the External Card Transfer Reversal to create
opts = {
idempotency_key: '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.
}
begin
# Create External Card Transfer Reversal
result = api_instance.create_external_card_transfer_reversal(transfer_id, transfer_reversal_request, opts)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->create_external_card_transfer_reversal: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> create_external_card_transfer_reversal_with_http_info(transfer_id, transfer_reversal_request, opts)
begin
# Create External Card Transfer Reversal
data, status_code, headers = api_instance.create_external_card_transfer_reversal_with_http_info(transfer_id, transfer_reversal_request, opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <TransferResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->create_external_card_transfer_reversal_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
transfer_id | String | The unique identifier of a transfer | |
transfer_reversal_request | TransferReversalRequest | Details of the External Card Transfer Reversal to create | |
idempotency_key | String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry. | [optional] |
- Content-Type: application/json
- Accept: application/json, application/problem+json
delete_external_card(external_card_id)
Delete External Card
Delete an External Card
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
external_card_id = '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | The unique identifier of an external card
begin
# Delete External Card
result = api_instance.delete_external_card(external_card_id)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->delete_external_card: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> delete_external_card_with_http_info(external_card_id)
begin
# Delete External Card
data, status_code, headers = api_instance.delete_external_card_with_http_info(external_card_id)
p status_code # => 2xx
p headers # => { ... }
p data # => <DeleteResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->delete_external_card_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
external_card_id | String | The unique identifier of an external card |
- Content-Type: Not defined
- Accept: application/json, application/problem+json
get_external_card(external_card_id)
Get External Card
Get an External Card
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
external_card_id = '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | The unique identifier of an external card
begin
# Get External Card
result = api_instance.get_external_card(external_card_id)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->get_external_card: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> get_external_card_with_http_info(external_card_id)
begin
# Get External Card
data, status_code, headers = api_instance.get_external_card_with_http_info(external_card_id)
p status_code # => 2xx
p headers # => { ... }
p data # => <ExternalCardResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->get_external_card_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
external_card_id | String | The unique identifier of an external card |
- Content-Type: Not defined
- Accept: application/json, application/problem+json
get_external_card_transfer(transfer_id)
Get External Card Transfer
Get an External Card Transfer
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
transfer_id = '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | The unique identifier of a transfer
begin
# Get External Card Transfer
result = api_instance.get_external_card_transfer(transfer_id)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->get_external_card_transfer: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> get_external_card_transfer_with_http_info(transfer_id)
begin
# Get External Card Transfer
data, status_code, headers = api_instance.get_external_card_transfer_with_http_info(transfer_id)
p status_code # => 2xx
p headers # => { ... }
p data # => <TransferResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->get_external_card_transfer_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
transfer_id | String | The unique identifier of a transfer |
- Content-Type: Not defined
- Accept: application/json, application/problem+json
initialize3_ds(initialize3ds_request, opts)
Initialize 3DS
Initializes an External Card Transfer 3DS authentication.
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
initialize3ds_request = Synctera::Initialize3dsRequest.new({amount: 37, currency: 'USD', external_card_id: '7d943c51-e4ff-4e57-9558-08cab6b963c7'}) # Initialize3dsRequest | Details of the External Card Transfer 3DS authentication to initialize.
opts = {
idempotency_key: '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.
}
begin
# Initialize 3DS
result = api_instance.initialize3_ds(initialize3ds_request, opts)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->initialize3_ds: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> initialize3_ds_with_http_info(initialize3ds_request, opts)
begin
# Initialize 3DS
data, status_code, headers = api_instance.initialize3_ds_with_http_info(initialize3ds_request, opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <Initialize3dsResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->initialize3_ds_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
initialize3ds_request | Initialize3dsRequest | Details of the External Card Transfer 3DS authentication to initialize. | |
idempotency_key | String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry. | [optional] |
- Content-Type: application/json
- Accept: application/json, application/problem+json
list_external_card_transfers(opts)
List External Card Transfers
Get a paginated list of External Card Transfers
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
opts = {
customer_id: ['7d943c51-e4ff-4e57-9558-08cab6b963c7'], # Array<String> |
type: Synctera::TransferType::PULL, # TransferType | The type of an external transfer
originating_account_id: ['7d943c51-e4ff-4e57-9558-08cab6b963c7'], # Array<String> |
external_card_id: '38400000-8cf0-11bd-b23e-10b96e4ef00d', # String |
page_token: 'a8937a0d', # String |
limit: 100 # Integer |
}
begin
# List External Card Transfers
result = api_instance.list_external_card_transfers(opts)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->list_external_card_transfers: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> list_external_card_transfers_with_http_info(opts)
begin
# List External Card Transfers
data, status_code, headers = api_instance.list_external_card_transfers_with_http_info(opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <TransferListResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->list_external_card_transfers_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
customer_id | Array<String> | [optional] | |
type | TransferType | The type of an external transfer | [optional] |
originating_account_id | Array<String> | [optional] | |
external_card_id | String | [optional] | |
page_token | String | [optional] | |
limit | Integer | [optional][default to 100] |
- Content-Type: Not defined
- Accept: application/json, application/problem+json
list_external_cards(opts)
List External Cards
Get a paginated list of External Cards
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
opts = {
customer_id: '38400000-8cf0-11bd-b23e-10b96e4ef00d', # String |
business_id: '38400000-8cf0-11bd-b23e-10b96e4ef00d', # String |
page_token: 'a8937a0d', # String |
status: Synctera::ExternalCardStatus::ACTIVE, # ExternalCardStatus |
limit: 100 # Integer |
}
begin
# List External Cards
result = api_instance.list_external_cards(opts)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->list_external_cards: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> list_external_cards_with_http_info(opts)
begin
# List External Cards
data, status_code, headers = api_instance.list_external_cards_with_http_info(opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <ExternalCardListResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->list_external_cards_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
customer_id | String | [optional] | |
business_id | String | [optional] | |
page_token | String | [optional] | |
status | ExternalCardStatus | [optional] | |
limit | Integer | [optional][default to 100] |
- Content-Type: Not defined
- Accept: application/json, application/problem+json
lookup3_ds(lookup3ds_request, opts)
Lookup 3DS
Using device collection data, performs a lookup for an External Card Transfer 3DS authentication. The results will indicate whether the transfer is successfully authenticated or if a 3DS challenge is required.
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
lookup3ds_request = Synctera::Lookup3dsRequestBrowser.new({authentication_indicator: 'INSTALLMENT', device_channel: 'BROWSER', id: '7d943c51-e4ff-4e57-9558-08cab6b963c7', transaction_mode: 'COMPUTER_DEVICE'}) # Lookup3dsRequest | Details of the External Card Transfer 3DS authentication lookup.
opts = {
idempotency_key: '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.
}
begin
# Lookup 3DS
result = api_instance.lookup3_ds(lookup3ds_request, opts)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->lookup3_ds: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> lookup3_ds_with_http_info(lookup3ds_request, opts)
begin
# Lookup 3DS
data, status_code, headers = api_instance.lookup3_ds_with_http_info(lookup3ds_request, opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <Lookup3dsResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->lookup3_ds_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
lookup3ds_request | Lookup3dsRequest | Details of the External Card Transfer 3DS authentication lookup. | |
idempotency_key | String | An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry. | [optional] |
- Content-Type: application/json
- Accept: application/json, application/problem+json
update_external_card(external_card_id, external_card_update_request)
Update External Card
Update External Card data
require 'time'
require 'synctera'
# setup authorization
Synctera.configure do |config|
# Configure Bearer authorization (api_key): bearerAuth
config.access_token = 'YOUR_BEARER_TOKEN'
end
api_instance = Synctera::ExternalCardsApi.new
external_card_id = '7d943c51-e4ff-4e57-9558-08cab6b963c7' # String | The unique identifier of an external card
external_card_update_request = Synctera::ExternalCardUpdateRequest.new({status: Synctera::ExternalCardStatus::ACTIVE}) # ExternalCardUpdateRequest | Fields to update
begin
# Update External Card
result = api_instance.update_external_card(external_card_id, external_card_update_request)
p result
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->update_external_card: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> update_external_card_with_http_info(external_card_id, external_card_update_request)
begin
# Update External Card
data, status_code, headers = api_instance.update_external_card_with_http_info(external_card_id, external_card_update_request)
p status_code # => 2xx
p headers # => { ... }
p data # => <ExternalCardResponse>
rescue Synctera::ApiError => e
puts "Error when calling ExternalCardsApi->update_external_card_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
external_card_id | String | The unique identifier of an external card | |
external_card_update_request | ExternalCardUpdateRequest | Fields to update |
- Content-Type: application/json
- Accept: application/json, application/problem+json