code 21052 - originator bankId is not valid

[ederius3]

Hi from the Colombia community. At this moment I'm trying to implement the Visa Direct Payout v2 service using the sandbox API. Using the example put in the documentation I'm getting the following error answer:

{"errorResponse":{"status":400,"reason":"invalidBankParameter","message":"Bank Request has invalid
Parameter","details":[{"location":"originatorDetail.bankId","message":"originator bankId is not valid","code":21052}]}}

Reviewing some previous posts related to this I saw some answers about using the bankId we can find in the Test Data section but the section where we can find it doesn't appear to me. Can someone help me?

[jenn_kh]

Hi, @ederius3. Thank you for your question! Our agent is looking into this and will get back to you with a potential solution. In the meantime, if anyone has any ideas that you feel may help, please share them here!

[API_Products · Accepted solution]

Hi @ederius3,

I ran a sandbox test today and received a successful request/response payload. Please see my sample payload below that you can use and try your test again. Please make sure to enable MLE when testing. Please share your result with us and let me know if the error is fixed.

End Point https://sandbox.api.visa.com/visapayouts/v2/payouts
Method POST
Request
{
"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": "2021-12-14T01:09:58",
"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"
}
}
Response
{
"_links": {"self": {
"href": "visapayouts/v2/payouts",
"type": "POST"
}},
"originatorDetail": {
"bankId": "408999",
"originatorId": "CAIDCode77765"
},
"transactionDetail": {
"systemTraceAuditNumber": "198333",
"transactionIdentifier": "793836168195902",
"retrievalReferenceNumber": "134820403397",
"endToEndId": "34214235345",
"payoutId": "49ace9c0-2cbb-11b2-67e3-fd16a805ef10_1",
"clientReferenceId": "1aehjh33-2114wd-333s",
"originalResponseCode": "00",
"payoutSpeed": "STANDARD",
"responseCode": "94",
"transmissionDateTime": "2021-12-14T11:05:00.000Z",
"destinationCurrencyCode": "840",
"expectedPostingDate": "2020-05-22",
"transactionAmount": 1000,
"transactionCurrencyCode": "840",
"destinationAmount": 1000
}
}
Response Header
Status Code: 200 OK
Server : nginx
Date : Wed, 25 May 2022 16:34:06 GMT
Content-Type : application/json;charset=UTF-8
Content-Length : 1424
Connection : keep-alive
X-SERVED-BY : c6795c5b4
X-CORRELATION-ID : 1653496445_480_1786242980_c6795c5b4_VDP_WS
X-APP-STATUS : 200
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
X-XSS-Protection : 1; mode=block
X-Content-Type-Options : nosniff
Strict-Transport-Security : max-age=31536000;includeSubdomains;always

[ederius3]

Thanks, So useful the answer Diana.

[marcelomonteiro]

Hello @API_Products 

I tried that payload and it gives me this error:

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

Can you please provide a working payload? That's all I need to guarantee the integration with your service. I'm looking for the payload all over the internet, but couldn't find one.

I would appreciate if you helped me.

Best regards.

[jenn_kh]

Thank you for reaching out, @marcelomonteiro! An agent is looking into this and will get back to you soon. -Jenn