Value provided for one or more request parameters is considered invalid in visa direct payout api

[DianaTran-Yee]

Hi @sam_ ,

Please answer the questions that I have asked of you in my previous community forum reply to you.

[DianaTran-Yee]

Hi @sam_ ,

I haven't receive a reply from you, hence, I'll take you off my contact list. Feel free to let us know if you have questions or need help.

[piper]

Will you please check, why i getting those error

[HTTP Status: 400] [HTTP/1.1 400 Bad Request Server: nginx Date: Sat, 06 Aug 2022 07:45:19 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 888 Connection: keep-alive X-SERVED-BY: c6795c5n8 X-CORRELATION-ID: 1659771918_972_1743674286_c6795c5n8_VDP_WS X-ERROR-ORIGIN: 9900 X-APP-STATUS: 400 encrypted: true Content-Language: en-US Cache-Control: no-cache, no-store, must-revalidate X-Frame-Options: SAMEORIGIN X-XSS-Protection: 0 X-Content-Type-Options: nosniff Strict-Transport-Security: max-age=31536000;includeSubdomains Pragma: no-cache Expires: -1

{"encData":"eyJjdHkiOiJhcHBsaWNhdGlvblwvanNvbjtjaGFyc2V0PVVURi04IiwiZW5jIjoiQTEyOEdDTSIsImlhdCI6MTY1OTc3MTkxOTY4NCwiYWxnIjoiUlNBLU9BRVAtMjU2In0.kyaq8G3X1fiTjnU4FDNv_wAd2qIBEqbNX5Z-8X18XNAOke4vpRE07q9p_L6Uy6bQOQIzlZjxeRrBcRoWOCdf13cz_LRUB4RjAkLQr6meGv8OToNzN3flvfVFD_Z88K1c7KDDxtpMinQoJdI8czNP-TzRV7SXNIe9PyDYKmfNQV-hVmR70ghuISe09KH7VZ72IccORTb1xfC2wvDLtqrqZa-KsitCdTagHuyTAFieFkvTHUu4W5xWIcYfCMHQEdYCxqRzSXOrNWGOkQT5Qsbz9zWCIivYe7rKmkRPmNPd7j8Ojh1ZtA536gaHcpeKCB1S7BC8i9BJBFSiFBXAA1SQwg.BmiMhISlHJ5LjMQ9.nSBepzQYXsGIu914Ht1PDMbJ140f1-9k03aYzeg4vGU8jgkwcoDcXHI6xXpUDNXat8jYBYrTGsuqbS6HlU4UEy1OoIEYnbKBPxs0792GR9g_1hygX8xK3ulGvBSUfCnb2bfLcSkqHlgFhcwXV3VJLh1CCnfz_eYg_FMDX99arevJfnM5jBncYdrZ2pa0xMF6IYkyapsp8w2lSfiBS5uZvUmHfTvxdGwzqEtjEUENwXh0-aTtQUSe-HiHC19LIFt1xXA6SVAJ1RjCHv7Sb9Pg-VBa-fFA9YogA6AeySXB7WvlXqLuQYWWEeG9oZ3hJ-vbv4huhPJuCjaFScoRkIRrp6fcySRctzM6YplIPW0.wVnO-VpWcVVuqEZuEyhLYA"}]

Error connecting to the API (https://sandbox.api.visa.com/visapayouts/v2/payouts)

"{"errorResponse":{"status":400,"reason":"invalidBankParameter","message":"Bank Request has invalid Parameter","details":[{"location":"transactionDetail.retrievalReferenceNumber","message":"transactionDetail retrievalReferenceNumber has invalid content","code":31051}]}} ◀"

[jenn_kh]

Thank you for reaching out, @piper! One of our agents will look into this and get back to you soon. If anyone else has any ideas you feel may help, you're welcome to share them here. -Jenn

[I_Doroteo3]

Hi @piper, 

To further investigate the error, please provide the information below.

1. Endpoint
2. Request Header
3. Request Body
4. Response Header (include the x-correlation-id)
5. Response Body

Using SoapUI, you can find the x-correlation-id in the Raw Tab of the response header.

Thanks, 

Illana

[piper]

1. Endpoint - https://sandbox.api.visa.com/visapayouts/v2/payouts

2. Request Header -
'Content-Type: application/json',
'Accept: application/json',
'keyId:  keyid' 

3. Request Body :

'{
"recipientDetail": {
"firstName": "Sam",
"lastName": "Smith",
"cityOfBirth": "Delhi",
"bank": {
"branchCode": "202212",
"bankCode": "9874",
"bankCodeType": "DEFAULT",
"accountNumberType": "DEFAULT",
"accountName": "Money Market",
"countryCode": "356",
"accountType": "1",
"bankName": "Berlin Bank",
"accountNumber": "20312421312",
"currencyCode": "356"
},
"address": {
"country": "356",
"city": "Delhi",
"postalCode": "401301",
"addressLine1": "address Line 1",
"addressLine2": "address Line 2",
"state": "765"
},
"countryOfBirth": "356",
"contactEmail": "abc@visa.com",
"contactNumber": "123456789",
"dateOfBirth": "1989-01-01",
"type": "I",
"payoutMethod": "B"
},

"senderDetail": {
"senderReferenceNumber": "2628176127",
"cityOfBirth": "Delhi",
"address": {
"country": "356",
"city": "Delhi",
"postalCode": "26281",
"addressLine1": "address line1",
"addressLine2": "address line2",
"state": "Delhi"
},
"countryOfBirth": "356",
"contactEmail": "abc@visa.com",
"name": "John Smith",
"contactNumber": "123456789",
"beneficiaryRelationship": "partner",
"dateOfBirth": "1989-01-01",
"sourceOfFunds": "01",
"type": "C",
"sourceOfIncome": "business"
},
"originatorDetail": {
"paymentFacilitator": {
"country": "840",
"name": "ABC Corp",
"id": "123476876"
},
"originatorName": "Visa Inc. GER",
"bankId": "408999",
"address": {
"country": "356",
"postalCode": "94404",
"state": "CA",
"addressLine": "Street 1"
},
"originatorBIC": "CTBAAU2S",
"merchantCategoryCode": "6012",
"bankBIC": "CTBAAU2S",
"originatorId": "CAIDCode77765"
},
"transactionDetail": {
"systemTraceAuditNumber": "198333",
"localTransactionDateTime": "' . $localTransactionDateTime . '",
"businessApplicationId": "FD",
"statementNarrative": "Advance payment",
"transactionAmount": "1000",
"purposeOfPayment": "ANN",
"transactionCurrencyCode": "840",
"additionalData": [
{
"name": "Name1",
"value": "Value1"
},
{
"name": "Name2",
"value": "Value2"
}
],
"retrievalReferenceNumber": "134820403397",
"clientReferenceId": "1aehjh33-2114wd-333s",
"endToEndId": "34214235345",
"payoutSpeed": "standard"
}
}'

4. Response Header (include the x-correlation-id):

array:22 [
0 => "HTTP/1.1 400"
"Server" => "nginx"
"Date" => "Sun, 21 Aug 2022 06:13:16 GMT"
"Content-Type" => "application/json;charset=UTF-8"
"Content-Length" => "888"
"Connection" => "keep-alive"
"X-SERVED-BY" => "-59647d7b68-5"
"X-CORRELATION-ID" => "1661062396_076_137595900_-59647d7b68-5_VDP_WS"
"X-ERROR-ORIGIN" => "9900"
"X-APP-STATUS" => "400"
"encrypted" => "true"
"Content-Language" => "en-US"
"Cache-Control" => "no-cache, no-store, must-revalidate"
"X-Frame-Options" => "SAMEORIGIN"
"X-XSS-Protection" => "0"
"X-Content-Type-Options" => "nosniff"
"Strict-Transport-Security" => "max-age=31536000;includeSubdomains"
"Pragma" => "no-cache"
"Expires" => "-1"
"Content-Security-Policy-Report-Only" => "default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport; "
"X-Content-Security-Policy-Report-Only" => "default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport; "
"X-WebKit-CSP-Report-Only" => "default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport; "
]

5. Response Body:

"{"errorResponse":{"status":400,"reason":"invalidBankParameter","message":"Bank Request has invalid Parameter","details":[{"location":"transactionDetail.retrievalReferenceNumber","message":"transactionDetail retrievalReferenceNumber has invalid content","code":31051}]}

[piper]

1. Endpoint - https://sandbox.api.visa.com/visapayouts/v2/payouts

2. Request Header -

'Content-Type: application/json',
'Accept: application/json',
'keyId: ' keyId

3. Request Body : '{
"recipientDetail": {
"firstName": "Sam",
"lastName": "Smith",
"cityOfBirth": "Delhi",
"bank": {
"branchCode": "202212",
"bankCode": "9874",
"bankCodeType": "DEFAULT",
"accountNumberType": "DEFAULT",
"accountName": "Money Market",
"countryCode": "356",
"accountType": "1",
"bankName": "Berlin Bank",
"accountNumber": "20312421312",
"currencyCode": "356"
},
"address": {
"country": "356",
"city": "Delhi",
"postalCode": "401301",
"addressLine1": "address Line 1",
"addressLine2": "address Line 2",
"state": "765"
},
"countryOfBirth": "356",
"contactEmail": "abc@visa.com",
"contactNumber": "123456789",
"dateOfBirth": "1989-01-01",
"type": "I",
"payoutMethod": "B"
},

"senderDetail": {
"senderReferenceNumber": "2628176127",
"cityOfBirth": "Delhi",
"address": {
"country": "356",
"city": "Delhi",
"postalCode": "26281",
"addressLine1": "address line1",
"addressLine2": "address line2",
"state": "Delhi"
},
"countryOfBirth": "356",
"contactEmail": "abc@visa.com",
"name": "John Smith",
"contactNumber": "123456789",
"beneficiaryRelationship": "partner",
"dateOfBirth": "1989-01-01",
"sourceOfFunds": "01",
"type": "C",
"sourceOfIncome": "business"
},
"originatorDetail": {
"paymentFacilitator": {
"country": "840",
"name": "ABC Corp",
"id": "123476876"
},
"originatorName": "Visa Inc. GER",
"bankId": "408999",
"address": {
"country": "356",
"postalCode": "94404",
"state": "CA",
"addressLine": "Street 1"
},
"originatorBIC": "CTBAAU2S",
"merchantCategoryCode": "6012",
"bankBIC": "CTBAAU2S",
"originatorId": "CAIDCode77765"
},
"transactionDetail": {
"systemTraceAuditNumber": "198333",
"localTransactionDateTime": "' . $localTransactionDateTime . '",
"businessApplicationId": "FD",
"statementNarrative": "Advance payment",
"transactionAmount": "1000",
"purposeOfPayment": "ANN",
"transactionCurrencyCode": "840",
"additionalData": [
{
"name": "Name1",
"value": "Value1"
},
{
"name": "Name2",
"value": "Value2"
}
],
"retrievalReferenceNumber": "134820403397",
"clientReferenceId": "1aehjh33-2114wd-333s",
"endToEndId": "34214235345",
"payoutSpeed": "standard"
}
}'

4. Response Header (include the x-correlation-id):

array:22 [
0 => "HTTP/1.1 400"
"Server" => "nginx"
"Date" => "Sun, 21 Aug 2022 06:13:16 GMT"
"Content-Type" => "application/json;charset=UTF-8"
"Content-Length" => "888"
"Connection" => "keep-alive"
"X-SERVED-BY" => "-59647d7b68-5"
"X-CORRELATION-ID" => "1661062396_076_137595900_-59647d7b68-5_VDP_WS"
"X-ERROR-ORIGIN" => "9900"
"X-APP-STATUS" => "400"
"encrypted" => "true"
"Content-Language" => "en-US"
"Cache-Control" => "no-cache, no-store, must-revalidate"
"X-Frame-Options" => "SAMEORIGIN"
"X-XSS-Protection" => "0"
"X-Content-Type-Options" => "nosniff"
"Strict-Transport-Security" => "max-age=31536000;includeSubdomains"
"Pragma" => "no-cache"
"Expires" => "-1"
"Content-Security-Policy-Report-Only" => "default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport; "
"X-Content-Security-Policy-Report-Only" => "default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport; "
"X-WebKit-CSP-Report-Only" => "default-src 'self' https://*.v.me https://*.visa.com;script-src 'self' 'unsafe-inline' 'unsafe-eval' https://*.visa.com https://*.v.me;img-src 'self' https://*.v.me https://*.visa.com https://*.unica.com https://ad.doubleclick.net;style-src 'self' 'unsafe-inline' https://*.visa.com;object-src https://*.v.me https://*.visa.com data:;report-uri /logging/logCSPReport; "
]

5. Response Body:

"{"errorResponse":{"status":400,"reason":"invalidBankParameter","message":"Bank Request has invalid Parameter","details":[{"location":"transactionDetail.retrievalReferenceNumber","message":"transactionDetail retrievalReferenceNumber has invalid content","code":31051}]}

[piper]

Will you please provide me sandbox data for visa direct payout.

[I_Doroteo3]

Hi @piper, 

Currently, there is no sandbox data available for Visa Direct Payouts. Please refer to the Visa Direct Payouts API Reference available for download on this page: https://developer.visa.com/capabilities/visa-direct-payouts/reference#tag/Payouts-Originator-Send-AP...

Regarding your previous issue, are you able to run a successful call with the request sample?

Thanks, 

Illana

[marcelomonteiro]

Hello @I_Doroteo3 . I appreciate you taking your time to help us.

I'm having the same problem as @piper .

I'm able to communicate with the API, and I succeeded in the Hello World test with the certificates and the keyId.

The only problem is the payload in the request, because I've tried the request example you mentioned and some others I found here in the Community but I'm receiving an error of invalid Bank Params as you can see below:

{"errorResponse":{"status":400,"reason":"invalidBankParameter","message":"Bank Request has invalid
Parameter","details":[]}

 So, I would like to get a valid params to test, in order to report the integration with Visa Direct API as successful here in my company.

Best Regards.