transferzero-sdk 1.4.0 → 1.5.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +9 -15
- data/docs/Document.md +5 -1
- data/docs/DocumentsApi.md +74 -2
- data/docs/PayinMethod.md +4 -4
- data/docs/PayinMethodDetails.md +4 -2
- data/docs/PayinMethodDetailsNGNBank.md +4 -2
- data/docs/PayoutMethod.md +1 -1
- data/docs/RecipientsApi.md +2 -2
- data/docs/Transaction.md +1 -1
- data/docs/TransactionTraits.md +2 -2
- data/example/client.rb +14 -14
- data/lib/transferzero-sdk.rb +0 -7
- data/lib/transferzero-sdk/api/documents_api.rb +63 -0
- data/lib/transferzero-sdk/api/recipients_api.rb +2 -2
- data/lib/transferzero-sdk/api_client.rb +1 -1
- data/lib/transferzero-sdk/models/currency_exchange.rb +1 -2
- data/lib/transferzero-sdk/models/currency_opposite.rb +1 -2
- data/lib/transferzero-sdk/models/document.rb +20 -1
- data/lib/transferzero-sdk/models/document_webhook.rb +0 -1
- data/lib/transferzero-sdk/models/payin_method.rb +4 -4
- data/lib/transferzero-sdk/models/payin_method_details.rb +12 -7
- data/lib/transferzero-sdk/models/payin_method_details_ngn_bank.rb +11 -6
- data/lib/transferzero-sdk/models/payout_method.rb +1 -1
- data/lib/transferzero-sdk/models/payout_method_webhook.rb +0 -1
- data/lib/transferzero-sdk/models/recipient_webhook.rb +0 -1
- data/lib/transferzero-sdk/models/sender.rb +1 -1
- data/lib/transferzero-sdk/models/sender_state.rb +1 -0
- data/lib/transferzero-sdk/models/sender_webhook.rb +0 -1
- data/lib/transferzero-sdk/models/transaction.rb +1 -1
- data/lib/transferzero-sdk/models/transaction_traits.rb +3 -3
- data/lib/transferzero-sdk/models/transaction_webhook.rb +0 -1
- data/lib/transferzero-sdk/models/webhook.rb +1 -1
- data/lib/transferzero-sdk/version.rb +1 -1
- data/spec/api/account_validation_api_spec.rb +2 -2
- data/spec/api/currency_info_api_spec.rb +2 -0
- data/spec/api/documents_api_spec.rb +15 -0
- data/spec/api/recipients_api_spec.rb +1 -1
- data/spec/api/transactions_api_spec.rb +13 -0
- data/spec/models/account_validation_request_spec.rb +7 -1
- data/spec/models/currency_opposite_spec.rb +6 -0
- data/spec/models/document_spec.rb +12 -0
- data/spec/models/payin_method_details_ngn_bank_spec.rb +6 -0
- data/spec/models/payin_method_details_spec.rb +6 -0
- data/spec/models/payout_method_details_spec.rb +7 -1
- data/spec/models/payout_method_details_xof_bank_spec.rb +1 -1
- data/spec/models/recipient_spec.rb +6 -0
- data/spec/models/sender_spec.rb +16 -0
- data/transferzero-sdk-1.4.0.gem +0 -0
- metadata +3 -32
- data/docs/CurrencyExchangeAllOf.md +0 -17
- data/docs/CurrencyOppositeAllOf.md +0 -19
- data/docs/DocumentWebhookAllOf.md +0 -17
- data/docs/PayoutMethodWebhookAllOf.md +0 -17
- data/docs/RecipientWebhookAllOf.md +0 -17
- data/docs/SenderWebhookAllOf.md +0 -17
- data/docs/TransactionWebhookAllOf.md +0 -17
- data/lib/transferzero-sdk/models/currency_exchange_all_of.rb +0 -204
- data/lib/transferzero-sdk/models/currency_opposite_all_of.rb +0 -212
- data/lib/transferzero-sdk/models/document_webhook_all_of.rb +0 -201
- data/lib/transferzero-sdk/models/payout_method_webhook_all_of.rb +0 -201
- data/lib/transferzero-sdk/models/recipient_webhook_all_of.rb +0 -201
- data/lib/transferzero-sdk/models/sender_webhook_all_of.rb +0 -201
- data/lib/transferzero-sdk/models/transaction_webhook_all_of.rb +0 -201
- data/spec/api_client_spec.rb +0 -189
- data/spec/models/currency_exchange_all_of_spec.rb +0 -41
- data/spec/models/currency_opposite_all_of_spec.rb +0 -41
- data/spec/models/document_webhook_all_of_spec.rb +0 -41
- data/spec/models/payout_method_webhook_all_of_spec.rb +0 -41
- data/spec/models/recipient_webhook_all_of_spec.rb +0 -41
- data/spec/models/sender_webhook_all_of_spec.rb +0 -41
- data/spec/models/transaction_webhook_all_of_spec.rb +0 -41
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 501bc663322a04ddda61c7d4567a826e068a459920730d2d0b10591376949c70
|
4
|
+
data.tar.gz: 0bc7115b3aefaa82d95309ab9ae3ffc82ed9ca7f8d40e6b764967790e9e74f5a
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 0e9c4f9d601c8e7d7429075cc9632cbf93b65752353cf6476cf63f855b5ba50850a5c50f254d66b410a090d3496fb9c5c6cf28444d4d77ccbaafe0f5890eefba
|
7
|
+
data.tar.gz: '09c080ee1b6656b6be9927abea4c49516310f70356f5fead6c647635757a1831bfbaf7ba53cecd10db7171ac824040d4969ccdbfdf40504151ddf6af30082a40'
|
data/README.md
CHANGED
@@ -7,15 +7,15 @@ Reference documentation for the TransferZero API V1
|
|
7
7
|
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
8
8
|
|
9
9
|
- API version: 1.0
|
10
|
-
- Package version: 1.
|
10
|
+
- Package version: 1.5.0
|
11
11
|
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
12
12
|
|
13
13
|
For more information, please visit:
|
14
14
|
|
15
|
-
* [API Documentation](https://
|
16
|
-
* [Onboarding guide](https://
|
17
|
-
* [Transaction flow](https://
|
18
|
-
* [Additional features](https://
|
15
|
+
* [API Documentation](https://docs.transferzero.com)
|
16
|
+
* [Onboarding guide](https://docs.transferzero.com/docs/quick-integration/)
|
17
|
+
* [Transaction flow](https://docs.transferzero.com/docs/transaction-flow/)
|
18
|
+
* [Additional features](https://docs.transferzero.com/docs/additional-features/)
|
19
19
|
* [API Specification](https://api.transferzero.com/documentation)
|
20
20
|
|
21
21
|
## Installation
|
@@ -31,15 +31,15 @@ gem build transferzero-sdk.gemspec
|
|
31
31
|
Then either install the gem locally:
|
32
32
|
|
33
33
|
```shell
|
34
|
-
gem install ./transferzero-sdk-1.
|
34
|
+
gem install ./transferzero-sdk-1.5.0.gem
|
35
35
|
```
|
36
|
-
(for development, run `gem install --dev ./transferzero-sdk-1.
|
36
|
+
(for development, run `gem install --dev ./transferzero-sdk-1.5.0.gem` to install the development dependencies)
|
37
37
|
|
38
38
|
or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
|
39
39
|
|
40
40
|
Finally add this to the Gemfile:
|
41
41
|
|
42
|
-
gem 'transferzero-sdk', '~> 1.
|
42
|
+
gem 'transferzero-sdk', '~> 1.5.0'
|
43
43
|
|
44
44
|
### Install from Git
|
45
45
|
|
@@ -115,6 +115,7 @@ Class | Method | HTTP request | Description
|
|
115
115
|
*TransferZero::CurrencyInfoApi* | [**info_currencies**](docs/CurrencyInfoApi.md#info_currencies) | **GET** /info/currencies | Getting a list of possible requested currencies
|
116
116
|
*TransferZero::CurrencyInfoApi* | [**info_currencies_in**](docs/CurrencyInfoApi.md#info_currencies_in) | **GET** /info/currencies/in | Getting a list of possible input currencies
|
117
117
|
*TransferZero::CurrencyInfoApi* | [**info_currencies_out**](docs/CurrencyInfoApi.md#info_currencies_out) | **GET** /info/currencies/out | Getting a list of possible output currencies
|
118
|
+
*TransferZero::DocumentsApi* | [**delete_document**](docs/DocumentsApi.md#delete_document) | **DELETE** /documents/{Document ID} | Deleting a document
|
118
119
|
*TransferZero::DocumentsApi* | [**get_document**](docs/DocumentsApi.md#get_document) | **GET** /documents/{Document ID} | Fetching a document
|
119
120
|
*TransferZero::DocumentsApi* | [**get_documents**](docs/DocumentsApi.md#get_documents) | **GET** /documents | Getting a list of documents
|
120
121
|
*TransferZero::DocumentsApi* | [**post_documents**](docs/DocumentsApi.md#post_documents) | **POST** /documents | Creating a document
|
@@ -165,11 +166,9 @@ Class | Method | HTTP request | Description
|
|
165
166
|
- [TransferZero::ApiLogResponse](docs/ApiLogResponse.md)
|
166
167
|
- [TransferZero::Currency](docs/Currency.md)
|
167
168
|
- [TransferZero::CurrencyExchange](docs/CurrencyExchange.md)
|
168
|
-
- [TransferZero::CurrencyExchangeAllOf](docs/CurrencyExchangeAllOf.md)
|
169
169
|
- [TransferZero::CurrencyExchangeListResponse](docs/CurrencyExchangeListResponse.md)
|
170
170
|
- [TransferZero::CurrencyListResponse](docs/CurrencyListResponse.md)
|
171
171
|
- [TransferZero::CurrencyOpposite](docs/CurrencyOpposite.md)
|
172
|
-
- [TransferZero::CurrencyOppositeAllOf](docs/CurrencyOppositeAllOf.md)
|
173
172
|
- [TransferZero::Debit](docs/Debit.md)
|
174
173
|
- [TransferZero::DebitListRequest](docs/DebitListRequest.md)
|
175
174
|
- [TransferZero::DebitListResponse](docs/DebitListResponse.md)
|
@@ -181,7 +180,6 @@ Class | Method | HTTP request | Description
|
|
181
180
|
- [TransferZero::DocumentRequest](docs/DocumentRequest.md)
|
182
181
|
- [TransferZero::DocumentResponse](docs/DocumentResponse.md)
|
183
182
|
- [TransferZero::DocumentWebhook](docs/DocumentWebhook.md)
|
184
|
-
- [TransferZero::DocumentWebhookAllOf](docs/DocumentWebhookAllOf.md)
|
185
183
|
- [TransferZero::ErrorStatus](docs/ErrorStatus.md)
|
186
184
|
- [TransferZero::FieldDescription](docs/FieldDescription.md)
|
187
185
|
- [TransferZero::FieldSelectValidation](docs/FieldSelectValidation.md)
|
@@ -214,14 +212,12 @@ Class | Method | HTTP request | Description
|
|
214
212
|
- [TransferZero::PayoutMethodRequest](docs/PayoutMethodRequest.md)
|
215
213
|
- [TransferZero::PayoutMethodResponse](docs/PayoutMethodResponse.md)
|
216
214
|
- [TransferZero::PayoutMethodWebhook](docs/PayoutMethodWebhook.md)
|
217
|
-
- [TransferZero::PayoutMethodWebhookAllOf](docs/PayoutMethodWebhookAllOf.md)
|
218
215
|
- [TransferZero::Recipient](docs/Recipient.md)
|
219
216
|
- [TransferZero::RecipientListResponse](docs/RecipientListResponse.md)
|
220
217
|
- [TransferZero::RecipientRequest](docs/RecipientRequest.md)
|
221
218
|
- [TransferZero::RecipientResponse](docs/RecipientResponse.md)
|
222
219
|
- [TransferZero::RecipientState](docs/RecipientState.md)
|
223
220
|
- [TransferZero::RecipientWebhook](docs/RecipientWebhook.md)
|
224
|
-
- [TransferZero::RecipientWebhookAllOf](docs/RecipientWebhookAllOf.md)
|
225
221
|
- [TransferZero::Sender](docs/Sender.md)
|
226
222
|
- [TransferZero::SenderListResponse](docs/SenderListResponse.md)
|
227
223
|
- [TransferZero::SenderRequest](docs/SenderRequest.md)
|
@@ -230,7 +226,6 @@ Class | Method | HTTP request | Description
|
|
230
226
|
- [TransferZero::SenderResponseMeta](docs/SenderResponseMeta.md)
|
231
227
|
- [TransferZero::SenderState](docs/SenderState.md)
|
232
228
|
- [TransferZero::SenderWebhook](docs/SenderWebhook.md)
|
233
|
-
- [TransferZero::SenderWebhookAllOf](docs/SenderWebhookAllOf.md)
|
234
229
|
- [TransferZero::Transaction](docs/Transaction.md)
|
235
230
|
- [TransferZero::TransactionListResponse](docs/TransactionListResponse.md)
|
236
231
|
- [TransferZero::TransactionRequest](docs/TransactionRequest.md)
|
@@ -240,7 +235,6 @@ Class | Method | HTTP request | Description
|
|
240
235
|
- [TransferZero::TransactionState](docs/TransactionState.md)
|
241
236
|
- [TransferZero::TransactionTraits](docs/TransactionTraits.md)
|
242
237
|
- [TransferZero::TransactionWebhook](docs/TransactionWebhook.md)
|
243
|
-
- [TransferZero::TransactionWebhookAllOf](docs/TransactionWebhookAllOf.md)
|
244
238
|
- [TransferZero::ValidationErrorDescription](docs/ValidationErrorDescription.md)
|
245
239
|
- [TransferZero::Webhook](docs/Webhook.md)
|
246
240
|
- [TransferZero::WebhookDefinition](docs/WebhookDefinition.md)
|
data/docs/Document.md
CHANGED
@@ -4,6 +4,7 @@
|
|
4
4
|
|
5
5
|
Name | Type | Description | Notes
|
6
6
|
------------ | ------------- | ------------- | -------------
|
7
|
+
**sender_id** | **String** | | [optional]
|
7
8
|
**upload** | **String** | Base64 encoded data uri of an image/pdf file or a fully qualified url |
|
8
9
|
**upload_file_name** | **String** | Name of the upload |
|
9
10
|
**metadata** | [**Object**](.md) | Metadata of document | [optional]
|
@@ -11,6 +12,7 @@ Name | Type | Description | Notes
|
|
11
12
|
**upload_file_size** | **Integer** | | [optional]
|
12
13
|
**category** | **String** | uncategorised | [optional]
|
13
14
|
**side** | **String** | The side of the KYC ID. One of 'front' or 'back' | [optional]
|
15
|
+
**document_type** | **String** | This is a brief description of the document type | [optional]
|
14
16
|
**issuing_country** | **String** | Issuing country of ID in 2-character alpha ISO 3166-2 country format | [optional]
|
15
17
|
**id** | **String** | | [optional]
|
16
18
|
**errors** | **Hash<String, Array<ValidationErrorDescription>>** | The fields that have some problems and don't pass validation | [optional]
|
@@ -20,13 +22,15 @@ Name | Type | Description | Notes
|
|
20
22
|
```ruby
|
21
23
|
require 'TransferZero'
|
22
24
|
|
23
|
-
instance = TransferZero::Document.new(
|
25
|
+
instance = TransferZero::Document.new(sender_id: ebe9bc0b-f2f6-4ce8-802a-8b79912d041e,
|
26
|
+
upload: data:image/png;base64,iVBORw0KGg...lFTkSuQmCC,
|
24
27
|
upload_file_name: example.png,
|
25
28
|
metadata: {},
|
26
29
|
upload_content_type: image/png,
|
27
30
|
upload_file_size: 30255,
|
28
31
|
category: null,
|
29
32
|
side: null,
|
33
|
+
document_type: certificate_of_business_name_registration,
|
30
34
|
issuing_country: NG,
|
31
35
|
id: ebe9bc0b-f2f6-4ce8-802a-8b79912d041e,
|
32
36
|
errors: {"phone_number":[{"error":"invalid"}],"documents":[{"error":"blank"}]})
|
data/docs/DocumentsApi.md
CHANGED
@@ -4,13 +4,79 @@ All URIs are relative to *https://api-sandbox.transferzero.com/v1*
|
|
4
4
|
|
5
5
|
Method | HTTP request | Description
|
6
6
|
------------- | ------------- | -------------
|
7
|
+
[**delete_document**](DocumentsApi.md#delete_document) | **DELETE** /documents/{Document ID} | Deleting a document
|
7
8
|
[**get_document**](DocumentsApi.md#get_document) | **GET** /documents/{Document ID} | Fetching a document
|
8
9
|
[**get_documents**](DocumentsApi.md#get_documents) | **GET** /documents | Getting a list of documents
|
9
10
|
[**post_documents**](DocumentsApi.md#post_documents) | **POST** /documents | Creating a document
|
10
11
|
|
11
12
|
|
13
|
+
# **delete_document**
|
14
|
+
> DocumentResponse delete_document(document_idopts)
|
15
|
+
|
16
|
+
Deleting a document
|
17
|
+
|
18
|
+
Deletes a single document by the Document ID
|
19
|
+
|
20
|
+
### Example
|
21
|
+
```ruby
|
22
|
+
# load the gem
|
23
|
+
require 'transferzero-sdk'
|
24
|
+
|
25
|
+
api_instance = TransferZero::DocumentsApi.new
|
26
|
+
|
27
|
+
opts = {
|
28
|
+
sender_id: 'sender_id_example' # String | Allows filtering results by `sender_id`. Example: `/v1/transactions?sender_id=b41d3cb7-6c54-4245-85fc-8e30690eb0f7`
|
29
|
+
}
|
30
|
+
|
31
|
+
begin
|
32
|
+
#Deleting a document
|
33
|
+
result = api_instance.delete_document(document_idopts)
|
34
|
+
p result
|
35
|
+
rescue TransferZero::ApiError => e
|
36
|
+
if e.validation_error
|
37
|
+
puts "WARN: Validation error occured when calling the endpoint"
|
38
|
+
result = e.response_object("DocumentResponse")
|
39
|
+
p result
|
40
|
+
else
|
41
|
+
puts "Exception when calling DocumentsApi->delete_document: #{e}"
|
42
|
+
end
|
43
|
+
end
|
44
|
+
```
|
45
|
+
|
46
|
+
### Parameters
|
47
|
+
|
48
|
+
Name | Type | Description | Notes
|
49
|
+
------------- | ------------- | ------------- | -------------
|
50
|
+
**document_id** | [**String**](.md)| ID of the document to delete. Example: `/v1/document/bf9ff782-e182-45ac-abea-5bce83ad6670` |
|
51
|
+
**sender_id** | **String**| Allows filtering results by `sender_id`. Example: `/v1/transactions?sender_id=b41d3cb7-6c54-4245-85fc-8e30690eb0f7` | [optional]
|
52
|
+
|
53
|
+
### Return type
|
54
|
+
|
55
|
+
[**DocumentResponse**](DocumentResponse.md)
|
56
|
+
|
57
|
+
### Authorization
|
58
|
+
|
59
|
+
You can set the API Key and Secret on the TransferZero object when setting it up:
|
60
|
+
|
61
|
+
```ruby
|
62
|
+
|
63
|
+
TransferZero.configure do |config|
|
64
|
+
config.api_key = '<key'
|
65
|
+
config.api_secret = '<secret>'
|
66
|
+
config.host = 'https://api-sandbox.transferzero.com/v1'
|
67
|
+
end
|
68
|
+
|
69
|
+
```
|
70
|
+
|
71
|
+
### HTTP request headers
|
72
|
+
|
73
|
+
- **Content-Type**: Not defined
|
74
|
+
- **Accept**: application/json
|
75
|
+
|
76
|
+
|
77
|
+
|
12
78
|
# **get_document**
|
13
|
-
> DocumentResponse get_document(
|
79
|
+
> DocumentResponse get_document(document_idopts)
|
14
80
|
|
15
81
|
Fetching a document
|
16
82
|
|
@@ -23,10 +89,13 @@ require 'transferzero-sdk'
|
|
23
89
|
|
24
90
|
api_instance = TransferZero::DocumentsApi.new
|
25
91
|
|
92
|
+
opts = {
|
93
|
+
sender_id: 'sender_id_example' # String | Allows filtering results by `sender_id`. Example: `/v1/transactions?sender_id=b41d3cb7-6c54-4245-85fc-8e30690eb0f7`
|
94
|
+
}
|
26
95
|
|
27
96
|
begin
|
28
97
|
#Fetching a document
|
29
|
-
result = api_instance.get_document(
|
98
|
+
result = api_instance.get_document(document_idopts)
|
30
99
|
p result
|
31
100
|
rescue TransferZero::ApiError => e
|
32
101
|
if e.validation_error
|
@@ -44,6 +113,7 @@ end
|
|
44
113
|
Name | Type | Description | Notes
|
45
114
|
------------- | ------------- | ------------- | -------------
|
46
115
|
**document_id** | [**String**](.md)| ID of the document to get. Example: `/v1/documents/bf9ff782-e182-45ac-abea-5bce83ad6670` |
|
116
|
+
**sender_id** | **String**| Allows filtering results by `sender_id`. Example: `/v1/transactions?sender_id=b41d3cb7-6c54-4245-85fc-8e30690eb0f7` | [optional]
|
47
117
|
|
48
118
|
### Return type
|
49
119
|
|
@@ -87,6 +157,7 @@ api_instance = TransferZero::DocumentsApi.new
|
|
87
157
|
opts = {
|
88
158
|
page: 1 # Integer | The page number to request (defaults to 1)
|
89
159
|
per: 10 # Integer | The number of results to load per page (defaults to 10)
|
160
|
+
sender_id: 'sender_id_example' # String | Allows filtering results by `sender_id`. Example: `/v1/transactions?sender_id=b41d3cb7-6c54-4245-85fc-8e30690eb0f7`
|
90
161
|
}
|
91
162
|
|
92
163
|
begin
|
@@ -110,6 +181,7 @@ Name | Type | Description | Notes
|
|
110
181
|
------------- | ------------- | ------------- | -------------
|
111
182
|
**page** | **Integer**| The page number to request (defaults to 1) | [optional]
|
112
183
|
**per** | **Integer**| The number of results to load per page (defaults to 10) | [optional]
|
184
|
+
**sender_id** | **String**| Allows filtering results by `sender_id`. Example: `/v1/transactions?sender_id=b41d3cb7-6c54-4245-85fc-8e30690eb0f7` | [optional]
|
113
185
|
|
114
186
|
### Return type
|
115
187
|
|
data/docs/PayinMethod.md
CHANGED
@@ -4,11 +4,11 @@
|
|
4
4
|
|
5
5
|
Name | Type | Description | Notes
|
6
6
|
------------ | ------------- | ------------- | -------------
|
7
|
-
**type** | **String** | Describes how the payment should be requested from the user. Possible values: - `NGN::Bank`: NGN card collection requests - `GHS::Mobile`: GHS mobile collections - `TZS::Mobile`: TZS mobile collections - `UGX::Mobile`: UGX mobile collections | [optional]
|
7
|
+
**type** | **String** | Describes how the payment should be requested from the user. Possible values: - `NGN::Bank`: NGN bank and card collection requests - `NGN::Mobile`: NGN mobile collections - `GHS::Mobile`: GHS mobile collections - `TZS::Mobile`: TZS mobile collections - `UGX::Mobile`: UGX mobile collections - `EUR::Bank`: EUR IBAN collections - `GBP::Bank`: GBP IBAN collections | [optional]
|
8
8
|
**in_details** | [**PayinMethodDetails**](PayinMethodDetails.md) | | [optional]
|
9
|
-
**out_details** | [**Object**](.md) | This will contain the description on where to pay the funds. Please see the [Collections
|
10
|
-
**instructions** | [**Object**](.md) | This will contain the instructions on how to pay the funds. Please see the [Collections
|
11
|
-
**provider** | **String** | Describes which provider to use for collection. Please see the [Collections
|
9
|
+
**out_details** | [**Object**](.md) | This will contain the description on where to pay the funds. Please see the [Collections Details](https://docs.transferzero.com/docs/collection-details) in the API documentation on what to expect here. | [optional]
|
10
|
+
**instructions** | [**Object**](.md) | This will contain the instructions on how to pay the funds. Please see the [Collections Details](https://docs.transferzero.com/docs/collection-details) in the API documentation on what to expect here. | [optional]
|
11
|
+
**provider** | **String** | Describes which provider to use for collection. Please see the [Collections Details](https://docs.transferzero.com/docs/collection-details) in the API documentation on the valid values | [optional]
|
12
12
|
|
13
13
|
## Code Sample
|
14
14
|
|
data/docs/PayinMethodDetails.md
CHANGED
@@ -4,7 +4,8 @@
|
|
4
4
|
|
5
5
|
Name | Type | Description | Notes
|
6
6
|
------------ | ------------- | ------------- | -------------
|
7
|
-
**
|
7
|
+
**payment_method** | **String** | The payment method which the user will use to make the payments. Options are `bank`, `card` or you can leave empty to support both. | [optional]
|
8
|
+
**redirect_url** | **String** | This is where the user should be redirected back when the payment has been finished | [optional]
|
8
9
|
**phone_number** | **String** | The phone number where the funds should be collected from |
|
9
10
|
**send_instructions** | **Boolean** | States whether to send out the instructions to the phone number on how to pay the funds or not. This shuold always be set to true, otherwise the sender might not receive a prompt for payment. | [optional]
|
10
11
|
|
@@ -13,7 +14,8 @@ Name | Type | Description | Notes
|
|
13
14
|
```ruby
|
14
15
|
require 'TransferZero'
|
15
16
|
|
16
|
-
instance = TransferZero::PayinMethodDetails.new(
|
17
|
+
instance = TransferZero::PayinMethodDetails.new(payment_method: null,
|
18
|
+
redirect_url: null,
|
17
19
|
phone_number: +2569999999,
|
18
20
|
send_instructions: true)
|
19
21
|
```
|
@@ -4,14 +4,16 @@
|
|
4
4
|
|
5
5
|
Name | Type | Description | Notes
|
6
6
|
------------ | ------------- | ------------- | -------------
|
7
|
-
**
|
7
|
+
**payment_method** | **String** | The payment method which the user will use to make the payments. Options are `bank`, `card` or you can leave empty to support both. | [optional]
|
8
|
+
**redirect_url** | **String** | This is where the user should be redirected back when the payment has been finished | [optional]
|
8
9
|
|
9
10
|
## Code Sample
|
10
11
|
|
11
12
|
```ruby
|
12
13
|
require 'TransferZero'
|
13
14
|
|
14
|
-
instance = TransferZero::PayinMethodDetailsNGNBank.new(
|
15
|
+
instance = TransferZero::PayinMethodDetailsNGNBank.new(payment_method: null,
|
16
|
+
redirect_url: null)
|
15
17
|
```
|
16
18
|
|
17
19
|
|
data/docs/PayoutMethod.md
CHANGED
@@ -4,7 +4,7 @@
|
|
4
4
|
|
5
5
|
Name | Type | Description | Notes
|
6
6
|
------------ | ------------- | ------------- | -------------
|
7
|
-
**type** | **String** | Contains the currency to send the money to, and the type of the money movement Commonly used payout types are: - `NGN::Bank` - for Nigerian bank account payments. - `NGN::Mobile` - for Nigerian mobile money payments. - `GHS::Bank` - for Ghanaian bank account payments. - `GHS::Mobile` - for Ghanaian mobile money payments. - `UGX::Mobile` - for Ugandan mobile money payments. - `TZS::Mobile` - for Tanzanian mobile money payments. - `XOF::Mobile` - for Senegalese mobile money payments. - `XOF::Bank` - for Senegalese bank account payments. *** Currently in Beta phase *** - `XOF::Cash` - for Senegalese cash remittance payments. - `MAD::Cash` - for Moroccan cash remittance payments. - `EUR::Bank` - for IBAN bank transfers in EUR. - `GBP::Bank` - for IBAN bank transfers in GBP. You can also send funds to the internal balance using `CCY::Balance`, where `CCY` is the appropriate currency. See [Collection from senders](https://
|
7
|
+
**type** | **String** | Contains the currency to send the money to, and the type of the money movement Commonly used payout types are: - `NGN::Bank` - for Nigerian bank account payments. - `NGN::Mobile` - for Nigerian mobile money payments. - `GHS::Bank` - for Ghanaian bank account payments. - `GHS::Mobile` - for Ghanaian mobile money payments. - `UGX::Mobile` - for Ugandan mobile money payments. - `TZS::Mobile` - for Tanzanian mobile money payments. - `XOF::Mobile` - for Senegalese mobile money payments. - `XOF::Bank` - for Senegalese bank account payments. *** Currently in Beta phase *** - `XOF::Cash` - for Senegalese cash remittance payments. - `MAD::Cash` - for Moroccan cash remittance payments. - `EUR::Bank` - for IBAN bank transfers in EUR. - `GBP::Bank` - for IBAN bank transfers in GBP. You can also send funds to the internal balance using `CCY::Balance`, where `CCY` is the appropriate currency. See [Collection from senders](https://docs.transferzero.com/docs/additional-features/#collections-from-senders) for more info on how to collect money into internal balance | [optional]
|
8
8
|
**details** | [**PayoutMethodDetails**](PayoutMethodDetails.md) | | [optional]
|
9
9
|
**metadata** | [**Object**](.md) | Metadata of payout method. You can store any kind of information in this field. | [optional]
|
10
10
|
**id** | **String** | | [optional]
|
data/docs/RecipientsApi.md
CHANGED
@@ -91,7 +91,7 @@ opts = {
|
|
91
91
|
created_at_to: 'created_at_to_example' # String | End date to filter recipients by created_at range Allows filtering results by the specified `created_at` timeframe. Example: `/v1/recipients?created_at_from=2018-06-06&created_at_to=2018-06-08`
|
92
92
|
amount_from: 'amount_from_example' # String | Minimum amount to filter recipients by amount range. Allows filtering results by the specified `amount` range. When using this filter, the `currency` should also be specified. Example: `/v1/recipients?currency=NGN&amount_from=83.76672339&amount_to=83.76672339`
|
93
93
|
amount_to: 'amount_to_example' # String | Max amount to filter recipients by amount range. Allows filtering results by the specified `amount` range. When using this filter, the `currency` should also be specified. Example: `/v1/recipients?currency=NGN&amount_from=83.76672339&amount_to=83.76672339`
|
94
|
-
state: ['state_example'] # Array<String> | Allows filtering results by `state` of recipient. See [API Documentation - Recipient state](https://
|
94
|
+
state: ['state_example'] # Array<String> | Allows filtering results by `state` of recipient. See [API Documentation - Recipient state](https://docs.transferzero.com/docs/transaction-flow/#state) for possible states. Example: `/v1/recipients?state[]=error&state[]=initial`
|
95
95
|
currency: ['currency_example'] # Array<String> | Allows filtering results by `input_currency`. Additionally required when filtering by an amount range Example: `/v1/recipients?currency[]=KES¤cy[]=NGN`
|
96
96
|
}
|
97
97
|
|
@@ -120,7 +120,7 @@ Name | Type | Description | Notes
|
|
120
120
|
**created_at_to** | **String**| End date to filter recipients by created_at range Allows filtering results by the specified `created_at` timeframe. Example: `/v1/recipients?created_at_from=2018-06-06&created_at_to=2018-06-08` | [optional]
|
121
121
|
**amount_from** | **String**| Minimum amount to filter recipients by amount range. Allows filtering results by the specified `amount` range. When using this filter, the `currency` should also be specified. Example: `/v1/recipients?currency=NGN&amount_from=83.76672339&amount_to=83.76672339` | [optional]
|
122
122
|
**amount_to** | **String**| Max amount to filter recipients by amount range. Allows filtering results by the specified `amount` range. When using this filter, the `currency` should also be specified. Example: `/v1/recipients?currency=NGN&amount_from=83.76672339&amount_to=83.76672339` | [optional]
|
123
|
-
**state** | [**Array<String>**](String.md)| Allows filtering results by `state` of recipient. See [API Documentation - Recipient state](https://
|
123
|
+
**state** | [**Array<String>**](String.md)| Allows filtering results by `state` of recipient. See [API Documentation - Recipient state](https://docs.transferzero.com/docs/transaction-flow/#state) for possible states. Example: `/v1/recipients?state[]=error&state[]=initial` | [optional]
|
124
124
|
**currency** | [**Array<String>**](String.md)| Allows filtering results by `input_currency`. Additionally required when filtering by an amount range Example: `/v1/recipients?currency[]=KES&currency[]=NGN` | [optional]
|
125
125
|
|
126
126
|
### Return type
|
data/docs/Transaction.md
CHANGED
@@ -5,7 +5,7 @@
|
|
5
5
|
Name | Type | Description | Notes
|
6
6
|
------------ | ------------- | ------------- | -------------
|
7
7
|
**input_currency** | **String** | The input currency describes what currency the transaction will be paid in (3-character alpha ISO 4217 currency format). For example if you wish to create an EUR to NGN transaction then input currency should be set to EUR. |
|
8
|
-
**payin_methods** | [**Array<PayinMethod>**](PayinMethod.md) | Allows setting alternative collections, where funding the transaction is done through alternative means and not via account balance. For more information please see [Collections from senders](https://
|
8
|
+
**payin_methods** | [**Array<PayinMethod>**](PayinMethod.md) | Allows setting alternative collections, where funding the transaction is done through alternative means and not via account balance. For more information please see [Collections from senders](https://docs.transferzero.com/docs/additional-features/#collections-from-senders) in the API documentation | [optional]
|
9
9
|
**metadata** | [**Object**](.md) | Additional metadata to store on the transaction. If you widh to store your local transaction ID, you should add it here inside a `sendRef` field, and we will return this value back to you in the daily transaction reports. | [optional]
|
10
10
|
**sender** | [**Sender**](Sender.md) | |
|
11
11
|
**recipients** | [**Array<Recipient>**](Recipient.md) | The details of where the payment should go. although transactions can support paying out multiple recipients, usually one is provided. |
|
data/docs/TransactionTraits.md
CHANGED
@@ -4,8 +4,8 @@
|
|
4
4
|
|
5
5
|
Name | Type | Description | Notes
|
6
6
|
------------ | ------------- | ------------- | -------------
|
7
|
-
**auto_refund** | **Boolean** | Enables or disables the auto refund functionality. Please see [Auto cancellation and refund of transactions](https://
|
8
|
-
**account_validation** | **Boolean** | Enabled or disables the name validation functionality. Please see [Name validation in transactions](https://
|
7
|
+
**auto_refund** | **Boolean** | Enables or disables the auto refund functionality. Please see [Auto cancellation and refund of transactions](https://docs.transferzero.com/docs/additional-features/#auto-cancellation-and-refund-of-transactions) for more details | [optional]
|
8
|
+
**account_validation** | **Boolean** | Enabled or disables the name validation functionality. Please see [Name validation in transactions](https://docs.transferzero.com/docs/additional-features/#name-validation-in-transactions) for more details | [optional]
|
9
9
|
|
10
10
|
## Code Sample
|
11
11
|
|
data/example/client.rb
CHANGED
@@ -15,7 +15,7 @@ credentials = {
|
|
15
15
|
host: "https://api-sandbox.transferzero.com/v1"
|
16
16
|
}
|
17
17
|
|
18
|
-
# Please see our documentation at https://
|
18
|
+
# Please see our documentation at https://docs.transferzero.com
|
19
19
|
# and the API specification at http://api.transferzero.com/documentation/
|
20
20
|
# for more information.
|
21
21
|
|
@@ -39,7 +39,7 @@ class Client
|
|
39
39
|
end
|
40
40
|
|
41
41
|
def account_validation_example
|
42
|
-
# See https://
|
42
|
+
# See https://docs.transferzero.com/docs/additional-features/#bank-account-name-enquiry
|
43
43
|
# for more information on how this feature can be used
|
44
44
|
begin
|
45
45
|
request = TransferZero::AccountValidationRequest.new
|
@@ -63,7 +63,7 @@ class Client
|
|
63
63
|
end
|
64
64
|
|
65
65
|
def create_sender_example
|
66
|
-
# For more details on senders please check https://
|
66
|
+
# For more details on senders please check https://docs.transferzero.com/docs/transaction-flow/#sender
|
67
67
|
begin
|
68
68
|
api = TransferZero::SendersApi.new
|
69
69
|
sender = TransferZero::Sender.new
|
@@ -98,7 +98,7 @@ class Client
|
|
98
98
|
end
|
99
99
|
|
100
100
|
def get_sender_by_external_id_example
|
101
|
-
# Find more details on external IDs at https://
|
101
|
+
# Find more details on external IDs at https://docs.transferzero.com/docs/transaction-flow/#external-id
|
102
102
|
begin
|
103
103
|
opts = { external_id: 'SENDER-2b59def0' }
|
104
104
|
sender = TransferZero::SendersApi.new
|
@@ -113,7 +113,7 @@ class Client
|
|
113
113
|
end
|
114
114
|
|
115
115
|
def update_sender_example
|
116
|
-
# For more details on senders please check https://
|
116
|
+
# For more details on senders please check https://docs.transferzero.com/docs/transaction-flow/#sender
|
117
117
|
begin
|
118
118
|
api = TransferZero::SendersApi.new
|
119
119
|
sender = TransferZero::Sender.new
|
@@ -135,15 +135,15 @@ class Client
|
|
135
135
|
begin
|
136
136
|
api = TransferZero::TransactionsApi.new
|
137
137
|
transaction = TransferZero::Transaction.new
|
138
|
-
# Please check our documentation at https://
|
138
|
+
# Please check our documentation at https://docs.transferzero.com/docs/transaction-flow/
|
139
139
|
# for details on how transactions work.
|
140
140
|
|
141
141
|
sender = TransferZero::Sender.new
|
142
142
|
# When adding a sender to transaction, please use either an id or external_id. Providing both will result in a validation error.
|
143
|
-
# Please see our documentation at https://
|
143
|
+
# Please see our documentation at https://docs.transferzero.com/docs/transaction-flow/#sender
|
144
144
|
sender.id = 'ec33484c-4456-4625-a823-9704a3a54e68'
|
145
145
|
|
146
|
-
# You can find the various payout options at https://
|
146
|
+
# You can find the various payout options at https://docs.transferzero.com/docs/transaction-flow/#payout-details
|
147
147
|
ngn_bank_details = TransferZero::PayoutMethodDetails.new
|
148
148
|
ngn_bank_details.bank_account = '123456789'
|
149
149
|
ngn_bank_details.bank_account_type = TransferZero::PayoutMethodBankAccountTypeEnum::N20
|
@@ -155,17 +155,17 @@ class Client
|
|
155
155
|
payout_method.type = 'NGN::Bank'
|
156
156
|
payout_method.details = ngn_bank_details
|
157
157
|
|
158
|
-
# Please see https://
|
158
|
+
# Please see https://docs.transferzero.com/docs/transaction-flow/#requested-amount-and-currency
|
159
159
|
# on what the request amount and currencies do
|
160
160
|
recipient = TransferZero::Recipient.new
|
161
161
|
recipient.requested_amount = 10000
|
162
162
|
recipient.requested_currency = 'NGN'
|
163
163
|
recipient.payout_method = payout_method
|
164
164
|
|
165
|
-
# Similarly you can check https://
|
165
|
+
# Similarly you can check https://docs.transferzero.com/docs/transaction-flow/#requested-amount-and-currency
|
166
166
|
# on details about the input currency parameter
|
167
167
|
|
168
|
-
# Find more details on external IDs at https://
|
168
|
+
# Find more details on external IDs at https://docs.transferzero.com/docs/transaction-flow/#external-id
|
169
169
|
transaction.external_id = 'TRANSACTION-1f834add' # Optional field for customer's ID
|
170
170
|
transaction.input_currency = 'GBP'
|
171
171
|
transaction.sender = sender
|
@@ -188,7 +188,7 @@ class Client
|
|
188
188
|
end
|
189
189
|
|
190
190
|
def get_transaction_by_external_id_example
|
191
|
-
# Please see https://
|
191
|
+
# Please see https://docs.transferzero.com/docs/transaction-flow/#external-id
|
192
192
|
# for more details on external IDs
|
193
193
|
begin
|
194
194
|
opts = { external_id: 'TRANSACTION-1f834add' }
|
@@ -208,7 +208,7 @@ class Client
|
|
208
208
|
if transaction_id.nil?
|
209
209
|
puts "Transaction with ID #{transaction_id} does not exist"
|
210
210
|
else
|
211
|
-
# Please see https://
|
211
|
+
# Please see https://docs.transferzero.com/docs/transaction-flow/#funding-transactions
|
212
212
|
# on details about funding transactions
|
213
213
|
debit = TransferZero::Debit.new
|
214
214
|
debit.currency = 'GBP'
|
@@ -235,7 +235,7 @@ class Client
|
|
235
235
|
end
|
236
236
|
|
237
237
|
def webhook_parse_example
|
238
|
-
# Please see https://
|
238
|
+
# Please see https://docs.transferzero.com#webhooks
|
239
239
|
# for more details about how webhooks / callbacks work from our system
|
240
240
|
headers = {
|
241
241
|
"Authorization-Nonce": "<authorization-nonce>",
|